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Preface 


This manual contains detailed information for implementing IBM program 
products CICS/DOS/VS and CICS/OS/VS. It provides system programmers and 
system analysts with information that is primarily independent of the 
operating system; for example, it describes the use of CICS/VS macro 
instructions to generate CICS/VS management programs and service 
programs and to prepare system control tables and service tables. It is 
assumed that the reader has some knowledge and/or experience of the 
Basic Telecommunications Access Method (BTAM), the Telecommunications 
| Access Method (TCAM), or the Virtual Telecommunications Access Method 
| (VTAM) . 

This publication contains eight major parts: 

• Part 1. ••Introduction” describes the organization of the manual 
and the methods used in presenting the information. There is also 
a brief discussion on code compatibility across previous releases 
of CICS/VS. 

• Part 2. "System Generation” describes the macros and operands 
available for generating CICS/VS system programs. 

• Part 3. "Table Preparation" describes the macros and operands that 
can be used to generate CICS/VS system tables. 

• Part 4. "Recovery/Restart" contains reference and tutorial 
information on the facilities available for generating CICS/VS 
support for restoring the system after such abnormal conditions as 
a transaction abend, a system abend, and errors detected from 
terminals and logical units. 

• Part 5. Devices and Access Methods” provides guidance on system 
programming considerations relevant to certain device types and 
access methods. 

• Part 6. "Modifying CICS/VS” describes ways in which the system 
programmer can tailor the CICS/VS system to the requirements of the 
installation. 

• Part 7. "Data Sets” contains information that the system 
programmer may require to access files. 

• Part 8. "Host Processor Resource Estimation" gives detailed 
information on storage estimates in CICS/VS. 

The manual also contains the following appendixes: 
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— Appendix A. 

— Appendix B. 

— Appendix C. 

— Appendix D. 

— Appendix E. 

— Appendix F. 


Required Entries in CICS/VS Tables 

Examples of Terminal Control Table Preparation 

Program Generation Summary 

CICS/VS Statistics 

Error Messages and Codes 

Sample TCAM SHA Message Control Programs 
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References to CICS or CICS/VS in this publication relate to 
| CICS/DOS/VS and CICS/OS/VS. 

| In this publication, the term VTAM refers to ACF/VTAM, to ACF/VTAME 
| (CICS/DOS/VS only) , and to the Record Interface of ACF/TCAM (CICS/OS/VS 
| only). The term TCAM refers both to TCAM and to the DCB Interface of 
| ACF/TCAM. The term BTAM refers to BTAM (CICS/OS/VS only) and to BTAM-ES 
| (CICS/DOS/VS only) . For further details of system requirements, refer 
| to the publication CICS/VS General Information . 

This manual should be used in conjunction with the appropriate 
CICS/VS System Programmers Guide (DOS/VS or OS/VS) when generating the 
CICS/VS system and when preparing the system tables, which describe the 
environment that CICS/VS is to support. 

For further information concerning CICS/VS, see the following IBM 
publications: 


Customer Information Control System/Virtual Storage (CICS/VS) 

| Version 1 Release 5 : 

General Information , GC33—0066 

System/Application Design Guide , SC33—0068 

Application Programmers Reference Manual (Command Level) . SC33—0077 
Application Programmers Reference Manual (RPG II) , SC33—0085 
Application Programmers Reference Manual (Macro Level) » SC33—0079 
Operators Guide , SC33—0080 

System Programmers Guide (DOS/VS) . SC33—0070 
} System Programmer" s Guide (QS/VS) . SC33—0071 * 

I Diagnosis Reference , LC33—0105 

1 Data Areas (DOS/VS) , LY33-6033 

I Data Areas (OS/VS) , LY33-6035 * 

Messages and Codes , SC33-0081 
Problem Determination Guide . SC33—0089 
I IBM 3270 Guide , SC33-0096 

IBM 3600/3630 Guide , SC33-0072 
I IBM 3650/3680 Guide . SC33-0073 

J IBM 3767/3770/6670 Gui de. SC33-0074 

I IBM 3790/3730 Guide , SC33-0O75 

I Bntry Level System Users Guide (DOS/VS) , SC33—0086 
Program Debugging Reference Summary , SX33—6010 
Master Terminal Operator*s Reference Summary . SX33—6011 
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Application Programmer's Reference Summary (Command Level) . GX33—6012 
Master Index . SC33—0095 * 

The following IBM publications are also referred to in this manual. 
Where no order number is given for a publication, you should consult 
your IBM representative to ensure that you order the appropriate manuals 
for your operating system. 

| VSE/Advanced Functions System Generation . SC33—609 6 

| VSE/Advanced Functions System Control Statements . SC33—6095 

| VSE/Advanced Functions Macro Reference . SC24-5211 

| Psinq VSE/VSAM Commands and Macros . SC24—5144 

| Basic Telecommunications Access Method — Extended Support 

| (BTAM—ESI Programming . SC38-0293 

OS/VS Basic Telecommunications Access Method . GC27-6980 
OS/VS Data Management Macro Instructions . GC26—3793 
0S/VS1 JCL Reference . GC24-5099 
0S/YS2 JCL . GC28-0692 

IMS/VS Ptilities Reference Manual . SH20-9029 

Component Description 77 7 0 Audio Response Pnit Model 3 , 

GA27-2712 

IMS/VS Version 1 System Programming Reference Manual . SH20—9027 
IMS/VS Svstem/Application Design Guide . SH20-9025 
OS/VSl Planning and Ose Guide . GC24—5090 
0S/VS2 Planning and Pse Guide . GC28—0600 

OS/VSl Data Management for System Programmers . GC26—3837 
0S/VS2 System Program Library; Data Management . GC26—3830 
OS/VSl Storage Estimates . GC24—5094 

0S/VS2 Storage Estimates . GC28—0604 

DL/I DOS/VS Ptilities and Guide for the System Programmer . 

SH12-5412 

DL/I DOS/VS Application Programming Beference Manual Guide . 

SH12—5 411 

3735 Programmer's Guide . GC30—3001 
| Systems Network Architecture — Types of Logical Pnit to 

| Logical Pnit Sessions . GC20—1869 

| Systems Network Architecture — Function Description of 

t Logical Pnit Types . GC20—1868 
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Svstem/7 MSP/7 Host Program Preparation Facilities II on 
System/360 or Svstem/370: Assembler, Linkage Editor. Formatting 
Utility, and Soarce Preparation Program . 6C34-0007 
MSP/7 Macro Library/Relocatable; Coding the Input/Output 
Macros . GC34-0020 

IBM 3600 Finance Communication System Peatare Description 

for BSC3 Communication . GC22—9026 

OS/VS TCAM System Programmers Guide . GC30—2051 

OS/VS TCAM Application Programmers Guide . GC30—3036 

OS/VS TCAM Installation and Migration Guide. GC30—3039 

OS/VS TCAM Concepts and Applications . GC30—2049 

IBM 3270 Information Display System Component Description , 

GA27-2749 

Available at the same time as CICS/OS/VS Version 1 Release 5 
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Summary of Amendments to the Fourth Edition 


Information on the following new features has been included in the 
fourth edition of the manual, SC33-0069-3, for CICS/VS Version 1 Release 
5 : 

• Intercommunication facilities have been enhanced as follows: 

— Multiregion operation is supported by extensions to the DFHTCT 
TYPE=SYSTEM macro instruction, the TYPE=REGIOH version of the 
DFHTCT macro instruction, and the TYPE=REMOTE versions of the 
DFHTCT, DFHDCT, DFHFCT, DFHPCT, and DFHTST macro instructions. 

— Distributed transaction processing, including parallel 

sessions, is supported by the DFHPCT TYPE=PROFILB and DFHPCT 
TYPB=REMOTE macro instructions. 

• CICS/VS monitoring facilities are supported by the monitoring 
control table, which is generated by DFHMCT macro, and the MOHITOR 
operand of DFHSIT. 

• A new Chapter, 8.8, describes the data produced by the monitoring 
facilities, including the format of the SMF data that can be 
provided. 

• Extensions to the 3270 data stream for color, highlighting and 
programmed symbols are supported by additional values for the 
FEATURE operand of the DFHTCT TYPE=TERMINAL macro instruction. 

• Error message display in the default character set at the bottom of 
a 3270 display screen is supported by the ERRATT operand of the 
DFHTCT TYPE=TERMINAL macro instruction. 

• Specification of BTAM 3270 terminal types in the TCT and the DFHSG 
PROGRAM=TCP macro has been simplified. 

• Support for the new user exit facility is provided by extensions to 
the DFHPPT, DFHPCT, and DFHPLT macro instructions, and the facility 
is described in Chapter 6.2. 

• Command interpreter support is provided by extensions to the DFHPCT 
and DFHPPT macro instructions. 

• Support for the new master terminal is provided via the command 
interpreter. 

• Security is enhanced as follows: 

— Support for external security facilities, including (MVS only) 
RACF, is provided by the EXTSEC, XTRAN, and XPSB operands of 
the DFHSIT macro instruction and the EXTSEC operand of the 
DFHSNT TYPE=ENTRY and DFHPCT TYPE=ENTRY macro instructions. 

The external security facility interface is described in 
Chapter 6.6. 

— Resource security checking is supported by the RSL operand of 
the DFHDCT, DFHFCT, DFHJCT, DFHPCT, DFHPPT and DFHTST macro 
instructions. 
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The online Facility Error Recognition program (FERS) for BTAM 
terminal error reporting (CICS/DOS/VS only), is supported by the 
FERS operand of the DFHSIT macro instruction and extensions to 
DFHPPT and DFHPCT. 

OS console support (CICS/OS/VS only), which provides CICS/VS 
terminal support for the processor console, is supported by 
extensions to the DFHTCT macro instruction. 

The following DFHSG operands are no longer valid, they have been 
replaced by equivalent operands on DFHSIT and initialization 
overrides: 


DFHSG | 

PROGRAM^ 

OPERABD 

| DFHSIT/OVERRIDE 

1 

ATP | 

IHBUFF 

| ATPIHS 

ATP | 

OUTBUFF 

| ATPOUTS 

BMS 

PRGDLAY 

| PRGDLAY 

CSO 

BSD 

| BSD (CICS/DOS/VS only) 

CSA | 

WRKAREA 

| WRKAREA 

CS A 

DATFORM 

| DATFORM 

KCP 

OPSECUR 

| EXTSEC 


Modules previously generated from DFHSG PROGRAM=RSP are now 
generated from DFHSG PROGRAM=TCP. 

The default CICS/VS SVC number has changed to 216. 
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Summary of Amendments to the Third Edition 


The following information has been added in the third edition of the 
manual to cover the facilities provided by CICS/VS Version 1, Release 4: 

• System Generation 

— DFHSG PROGRAM=1SC has been added to provide intersystem 

communication support between two or more connected CICS/VS 
systems, or interregion communication between CICS/OS/VS and 
the DL/I batch region. 

— RPG II (CICS/DOS/VS only) and assembler language are supported 
under the command level application programming interface, and 
are specified in DFHSG PROGRAM=BXP. 

• Table Preparation 

- Intersystem communication support is provided through the 

DFHTCT TYPE=ISLINK, DFHDCT TYPE=REMOTE, DFHFCT TYPE=REMOTB, and 
DFHTST TYPE=REMOTE macro instructions. Interregion 
communication between CICS/OS/VS and the DL/I batch region is 
provided through the DFHTCT TYPE=IRCBCH macro and the IRBUFSZ 
operand in DFHSIT. 

— The transaction restart facility may be used to restart 

transactions automatically after an abnormal termination and 
subsequent dynamic transaction backout. This facility is 
provided through the RESTART operand in DFHPCT TYPE=ENTRY. 

— The 3770 Data Communication System may be used under VTAM in a 
manner similar to the 3790 full function logical unit. 
TRMTYPE=3770 and SESTYPE=USERPROG must be specified in the 
DFHTCT TYPE=TERMINAL macro. 

— The execution (command level) diagnostic facility (BDF) allows 
command—level application programs to be debugged before the 
program is executed. This facility is provided through the 
DFHPPT macro instruction. Appendix A contains further 
information. 

— New 3270 displays and printers can be used with CICS/VS. 

Information on how to generate this support can be found in the 
DFHPCT TYPE=INITIAL, DFHPCT TYPE=ENTRY, and DFHTCT 
TYPE=TERMINAL macros, and in Appendix D. 

The following technical and editorial changes have been made in this 
edition of the manual: 

• The macros of the destination control table, the file control 
table, and the terminal control table are arranged in alphabetic 
order within the TYPE=INITIAL and TYPE=FIMAL macros. 

• The DFHTCT TYPE=GPBNTRY macro (for CICS/DOS/VS only) is documented 
in full. 

• Chapters 2.3, 2.4, 3.3, and 3.4 have been created from the 
recovery/restart and DL/I information that were formerly in 
Chapters 2.2 and 3.2. 
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• Chapters 4.2 (”The Terminal Error Program”) and 4*3 ("The Node 
Error Program”) have been formed from the information that was 
formerly in Chapter 4.3. The information on system abends 
(formerly Chapter 4.2) now appears in Chapter 4.10. 

• The DFHPCT TYPE=GROUP and DFHPPT TYPE=GROOP macros have been added 
to the program control table and processing program table 
respectively, and allow the system programmer to specify CICS/VS— 
supplied transaction identifications and application program names 
in a simplified manner, on a function basis. Appendix A contains 
further information. 

• Part 8 ("Host Processor Resource Estimation”) has been restructured 
and expanded. 

In addition, in Technical Newsletter SN33-6217, the following major 
changes have been mads to the manual: 

• DFHSG TYPE=INITIAL : The DLI=REMOTE option has been added to allow 
users to indicate that all DL/I data bases to be accessed reside on 
remote CICS/VS systems. The SMPDATE, SMPLKED, and SMPSIZE operands 
have also been removed. 

• DFHSG PROGRAM=HLL : Support for the PL/I F Compiler has been 
removed. 

• DFHSG PROGRAM=TDP and DFHPCT TYPE=INITIAL : Support for VSAM 
intrapartition queues has been included. 

• DFHJCT TYPE=ENTRY : The SYSWAIT operand has been added to allow 
journal control input/output operations to be initiated 
immediately. 

• DFHNLT : The default load order for CICS/OS/VS Version 1, Release 4 
has been updated. The PROTECT operand has been provided for MVS 
users to load modules into a protected area of storage. 

• DFHSIT : The CICSSVC and SRBSVC operands have been removed. 

• Chapter 3.4 contains additional information on how to specify DLI 
support in CICS/VS tables. 

• Part 8 has been updated to include additional performance 
information, in particular on Intersystem Communication. 

Technical Newsletter SN33—6248 contains the following major changes 
to the manual, which have been added for CICS/VS Version 1.4.1: 

• The FBA keyword has been added to the JDEVICB operand (DFHJCT 
TYPE=ENTRY) and to the DEVICE operand in DFHSG TYPE=INITIAL, DFHSG 
PROGRAM=DCP, DFHSG PROGRAM=KPP, DFHSG PROGRAM=TRP, DFHDCT 
TYPE=SDSCI, and DFHTCT TYPE=SDSCI to provide support in CICS/DOS/VS 
for Fixed Block Architecture (FBA) disk devices. 

• The VTAMDEV operand in DFHSG PROGRAM=TCP and the TRMTYPE operand in 
DFHTCT TYPE=TERMINAL contain the LUTYPE4 option to provide support 
for the SNA type 4 logical unit. The DFHTCT TYPE=LDC macro has new 
options for defining logical device code mnemonics for this device. 

• The SESTYPE operand in DFHTCT TYPE=ISLINK has the new FASTSEND and 
FASTRECV parameters to provide support for the Intersystem 
Communication (ISC) Message Performance Option. 
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Summary of Amendments to the Second Edition 


Information on the following new features has been included in the 
second edition of the manual, SC33—0069—1, for CICS/VS Version 1, 

Release 3: f 

• Enhanced TCAM support, which allows devices on TCAM lines to be 
used in an SNA network. The main areas of the manual affected by 
this are: 

DFHTCT TYPE=LINB 

New TCAMFET=SNA operand 

Chapter 5.3. 

Discussion on CICS/OS/VS/TCAM SNA considerations 
Appendix F. 

Two sample TCAM SNA message control programs. 

• The addition of the BASE operand in DFHFCT TYPE=DATASET, which 
enables the user to specify the base data set in an alternate index 
structure. 

• Additional formatted dump program features provided by the FDUMP 
parameters in DFHPCT TYPE=INITIAL and in TYPE=ENTRY. 

• Appendix E has been extended to restore the descriptions of the 
error conditions detected by DFHTACP and by DFHNACP• 

In addition, in Technical Newsletter SN33—6233, information on the 
following topics has been added: 

• Program isolation scheduling. The ENQPL and PISCHD operands have 
been added to DFHSIT for CICS/OS/VS only. 

• New 3270 printers and displays. Details on how to generate support 
for these devices in an SNA environment can be found in the 
discussion on the TRMTYPE/SESTYPE operands in DFHTCT TYPE=TER2!INAL. 

• Recovery procedures for a multiprocessor environment, which can be 
found in Chapter 4.9. 
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Chapter 1.1. Introduction 


This manual is one of four manuals providing information about the 
design and installation of a CICS/VS system as follows: 

• CICS/VS Svstem/Application Design Guide provides information for 
system design teams and systems analysts on the functions and 
facilities available in CICS/VS and which may be suitable for a 
particular installation or application. 

• CICS/VS System Programmers Guide (DOS/VS and OS/VS) provides 
details on how to build and install a CICS/VS system. 

• CICS/VS System Programmer^ Referen c e Manual provides detailed 
information on the macros and operands available to the system 
programmer for generating and maintaining the CICS/VS system. 

The system programmer should ne familiar with the information in the 
appropriate CICS/VS System Programmer^ Guide on the improved 
installability aspects of CICS/VS (such as pregenerated modules) before 
using this manual. 


S TRUCTURE OF THIS MANUAL 


The information in the manual is divided into parts, each containing one 
or more chapters, dealing,with specific topics, Bach part has an 
introductory chapter, which outlines the information contained in that 
part. Parts 2 and 3, which deal with system generation and system table 
preparation respectively, are organized in alphabetical order by program 
and table acronym (for example, DPHSG PROGRAM=ATP precedes DPHSG 
PROGRAM=CSO)• The only exceptions to this rule are that TYPE-INITIAL 
and TYPE=FINAL take their logical places at the beginning and end. In 
addition to this, the operands within each program and table macro are 
in alphabetic order within the following structure: 

• Required operands for CICS/DOS/VS and CICS/OS/VS 

• Optional operands for CICS/DOS/VS and CICS/OS/VS 

• Optional operands for CICS/DOS/VS only 

• Optional operands for CICS/OS/VS only. 

The remainder of the manual comprises tutorial and reference 
information on other aspects of the CICS/VS system programmer # s 
responsibilities. As with Parts 2 and 3, each part begins with an 
introductory chapter and, where applicable, operands within macros are 
listed alphabetically. 


SYNTAX NOTATION 


The symbols [ ],{},! and ,... are used in this publication to help 

define the macro instructions. THESE SYMBOLS MUST NOT BE SPECIFIED; 
they act only to indicate how a macro instruction can be written; their 
definitions are given below: 
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The operand rield is used to specify the services and options to be 
generated. Operands are always in a keyword format and any parameters 
are specified according to the following general rules: 

• If the parameter associated with the operand is written in all 
capital letters (for example r TYPE=INITIAL), the operand and 
parameter must be specified exactly as shown. 

• If the parameter associated with the operand is written in lower 
case letters, the operand must be specified exactly as shown and 
the indicated value, address, or name for the lower case letters 
(for example, DATASET=name) must be substituted. 

• Commas and parentheses are specified exactly as shown, except that 
a comma following the last operand specified must be omitted. The 
use of commas and parentheses is indicated by brackets and braces, 
exactly as operands. The parentheses may be omitted when only one 
parameter of a particular operand is used. 

• Because a blank character indicates the end of the operand field, 
the operand field must not contain blanks except within quotes, 
after a comma on a continued line, or after the last operand of the 
macro instruction. The first operand on a continuation line must 
begin in column 16. 

• When a CICS/VS macro instruction is written on more than one line, 
each line containing part of the macro instruction (except the last 
line) must contain a character (for example, an asterisk) in column 
72, indicating that the macro instruction is continued on the next 
line • 


C ODE COMPATIBILITY 


The following definition of compatibility of system programming 
| interfaces applies to users changing to the current release of CICS/VS. 

| Users of earlier releases should also refer to the "Memorandum to Users" 
| distributed with each new release for a further discussion on 

compatibility, and to the CICS/VS Application Programmer 1 s Reference 
Manual (Macro Level) for a definition of application program 
compatibility. 

The system programming interfaces to CICS/VS fall into three 
categories: 

• Object-compatible interfaces (code that need not be reassembled) 

• Source-compatible interfaces (code that must be reassembled) 

• Interfaces for which neither source nor object compatibility is 

guaranteed 
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OBJECT-COMPATIBLE INTERFACES 


The following macro instructions generate code that is compatible across 
releases: 


DFHJC 

DFHJC TYPE=OPEN 
DFHJC TYPE =CLOSE 
DFHJC TYPE=GETB/GETF 
DFHJC TYPE=NOTE/POINT 
DFHJC TYPE= (GETJCA ,OPEN) 

DFHOC 

DFHOC TYPE=OPEN 
DFHOC TYPE=CLOSE 
DFHOC TYPE =SWITCfl 

DFHKP 

DFHKP TYPE=RTBOCTL 
DFHKP TYPE=RTBODATA 
DFHKP TYPE=RTBOEND 
DFHKP TYPE=CHECK 

DFHPC 

DFHPC TYPE=SETXIT 
DFHPC TYPE=RESETXIT 

N ote : Object compatibility also implies source compatibility. 


Control Block and Area Prefix Fields 


Many of the fields in CICS/VS (for example, CSA and TCA) or prefixes to 
user I/O areas (for example, FIOA and TIOA) are directly referenced by 
macro expansions. In addition, these and many other such fields are 
identified as directly accessible to user code. All these fields are 
| authorized for system or application programmer use and are unchanged in 
| offset (location), type, or meaning between the current and earlier 
j releases of CICS/VS. Programs that make correct use of them will 

continue to function under the latest release without being recompiled. 
User code that refers to fields in area prefixes or in CICS/VS control 
blocks that are not defined as part of the object-compatible interface 
may not continue to work. This is particularly likely where users refer 
to fields formerly marked as "unused" or "reserved" in releases of 
CICS/VS prior to the current release. All code containing such 
references must be recompiled and carefully examined, tested and, where 
necessary, modified to ensure correct operation. 

The following is a list of CICS/VS control blocks that form part of 
the system programmer # s interface to CICS/VS: 


DFHOCLDS DFHOCODS 

DFHJCRDS DFHTACLE 

A full list of field names contained in these and other CICS/VS 
control blocks that are considered to be part of the application or 
system programmer's interface to CICS/VS is contained in the CICS/VS 
I A pplication Programmer's Reference Manual (Macro Level) for the current 
| release of CICS/VS. The system programmer can refer to this list if 
there is any doubt about the validity of application or system 
programming references to control block or area prefix fields. 
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SOURCE-COMPATIBLE INTERFACES 


The following macros and routines are source—compatible across the 
above-mentioned releases: 

• DFHTC CTYPE macros 

• Node error programs (DFHZNEP) 

• Terminal error programs (DFHTEP) 

• Program error programs (DFHPEP) 

System programming code associated with these interfaces must be 
recompiled to ensure continued correct functioning. 


NON-COMPATIBLE INTERFACES 

The following interfaces cannot , by their very nature, be guaranteed to 
be either source— or object—compatible across releases: 

• System generation macros and Stage 1 output 

• Table preparation macros 

• User^written system initialization overlays 

• CICS/VS—supplied sample node and terminal error programs (DFHZNEP 
and DFHTEP) from earlier releases 

• User exit routines for CICS/VS management programs 

• User exit routines for the transaction backout program (DFHTBP) 

• User exits in the dynamic transaction backout program (DFHDBP) 

• User exit routines in the asynchronous transaction processor 
(DFHATP) 


The system programmer should be able to decide, by following the 
guidelines above, whether a CICS/VS compatibility problem is the result 
of incompatibility and may therefore be fixed by an APAR, and which of 
the system programs may need to be recompiled. 
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Chapter 2.1. Introduction 


The CICS/VS system generation process builds a library containing those 
CICS/VS management programs and service programs required for the needs 
of an installation. The process comprises three steps: 

• Coding a set of CICS/VS system generation (DFHSG) macro 
instructions to specify the required programs and to indicate how 
they should be tailored to meet the needs of the installation. 

• Assembling the macro instructions. 

• Executing the job stream that results from assembly of the macro 
instructions. 

The distribution volume on which CICS/VS is supplied contains a 
starter system library comprising ready—to—use pregenerated CICS/VS 
programs, tables, and sample application programs. The DPHSG macro 
instructions can be used for adding to or replacing items in the starter 
system library. It is recommended that the user install the starter 
system core—image library (load library) and tailor individual modules 
to specific needs. For information on the starter system library, refer 
to the appropriate CICS/VS System Progra m mers Guid e (DOS/VS or OS/VS) . 

Chapter 2.2 describes the system generation macro instructions. The 
process of assembling the macro instructions and executing the resultant 
job stream is described in the appropriate CICS/VS System Programmers 
Guide (DOS/VS or OS/VS). 

Chapters 2.3 and 2.4 discuss the system generation macros and 
operands that must be specified to provide support for CICS/VS recovery 
and restart facilities, and for using DL/I under CICS/VS. Equivalent 
details on system table preparation can be found in Chapters 3.3 and 

3.4. 


COD ING THE MA CRO INSTRUCTIONS 


A set of CICS/VS system generation macro instructions starts with a 
DFHSG TYPE=INITIAL instruction and finishes with a DFHSG TYPE=FINAL 
instruction. Between these two instructions is coded a series of 
instructions of the form DFHSG PROGRAM=xxx to specify the programs to be 
included in the CICS/VS library. 

DFHSG PROGRAtt=xxx macro instructions can be used to specify: 

• CICS/VS management programs 

• CICS/VS service programs 

| • CICS/VS utility program 

Some of the management programs and some of the service programs must 
always be specified? all other programs are optional. If some optional 
programs are omitted, dummy programs must be generated; the DFHSG 
PROGRAM=CSD macro instruction can be used for this purpose. 
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| Appendix C lists all of the programs that can ha specified, with the 
names of the relevant macro instructions and an indication of which 
| programs reguire a dummy program if the program function is not 
| required. 
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Chapter 2.2. System Generation 


This chapter describes the macros that caa be used to generate a CICS/VS 
system. 

The macro instructions are described in the following order: 

• DFHSG TYPE=INITIAL 

• DFHSG PROGRAM=xxx in alphabetic order of program name 

• DFHSG TYPE=FINAL 

In each case, the operands (except TYPE and PROGRAM, which always appear 
first) are listed in alphabetic order starting with the mandatory 
| operands. Operands that apply to FSB only or OS/VS only are listed 
separately in alphabetic order. The syntax notation is described in 
Chapter 1.1. 

| Certain operands appear in many of the system generation programs 
| without alteration to their meaning. These operands are listed in the 
| appropriate syntax display with a reference to this page for the 
| description of the operand. The operands in question are: 

| • PROGRAM=xxx 

| indicates that the appropriate CICS/VS system generation 

j program is to be generated. 

| • DUMMY=YES 

| specifies that a particular dummy program is to be generated. 

| This operand can be used instead of the DFHSG PROGRAM=CSD macro 

| instruction to generate a particular dummy program. Any other 

| operands that have been included in the DFHSG PROGRAM=xxx macro 

| instruction are ignored. 

| • STAGE2- {SELECTIVE |FORCE} 

| may be used to override the specification of the default, set 

| by the STAGE2 operand of DFHSG TYPE=INITIAL, for producing the 

j Stage 2 jobstream for this program. 

| SELECTIVE 

| indicates that the Stage 2 jobstream for this program will 

t be suppressed if that version of the program already exists 

| on the starter system library. 

| FORCE 

| forces generation of all Stage 2 jobs for this program. 

| • SUFFIX=xx 

| provides a one— or two—character suffix (other than NO or DY, 

| which are reserved) for the program being generated. 

Appendix C provides a list of the modules generated by the DFHSG 
macro instructions• 
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INITIALIZATION - DFaSG TYPB=INXTIAL 


A DFHSG TYPE=INITIAL macro instruction must precede each set of system 
generation macro instructions. Procedures developed from the use of 
this macro instruction can be reused for subsequent generations of the 
entire system or for parts of the system. 

The following modules are generated in response to this macro 
I instruction (CICS/OS/VS only): 

• DFaBPSVC — the service request block (SKB) type 6 SVC for the High 
Performance Option (HPO) 

| • DPHCSVC - the bootstrap type 2 SVC 

| • DFHASV — page fix/free routine 

Note : The STARTER=YES parameter is an internal operand used by IBN and 

is not intended for general use. It is documented here for reasons of 
completeness and clarity only. 
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IDFHSG 

| TYPE=INITIAL 

-1 


i 

1 r,ACCTID= fCICSIaccounting-information}} 



i 

1 r,ASMBLR=(IFOXOOlASSEMBLY 1assembler-name)1 



i 

I [, {DL1IDLI} = {SO (REMOTE| string! YES} ] 



i 

| [,EJECT={YES|n} ] 



i 

1 r.J0BNAME=fCICSI1obname) 1 



i 

| [ ,MOD= (program,[suffix][ ] 



i 

1 r .0PSYS=fVS1IMVSI'D0S/VSB») 1 



i 

1 T -PKINT=fr fll ST 1HOLIST) 1 



i 

1 [ . fXREFINOXREFISHORTXREF) 1 



i 

1 r . fDSECTINODSECTISOMEDSECT) 1 



i 

| [ ,DSLIST]) ] 



i 

1 f .STAGE2=(FORCE 1 SELECTIVE) 1 



i 

| [,STARTEE=YES] 



i 

| r , YSAB= (YES 1 NOt 1 



i 

| [ ,VSAMSHR={KO|YES} ] 



i 

1 

| [ ,VTAM={YES|HO}] 

i 



I 

i 

i 

1 CICS/DOS/VS Only 

ft 



1 

i 

i 

| r.DEVICB= (TAPE 123141333013340133501FBA) ] 

■ 



1 

i 

1 

I 

1 CICS/OS/VS only 

1 



1 

i 

1 

| r.CICSSVC=(2161namber)1 



i 

| [,DEBCHK={YES|HO}] 



i 

| [,SRBSVC=number] 



i 

| [,STATUS=FIRST] 



i 

■ 

1 T.TCTUA=(VARIABLEIV1COMPAT)1 

a 



I 

i 

i 

1 OS/VS JCL OPTIONS 

i 



1 

i 

1 

| [,CLASS=jobclass] 



i 

| [,CONDCD= ((code,operator),...) ] 



i 

| [,MSGCLAS=x] 



i 

| [ ,MSGLVL={0 1112} ] 



i 

1 r »PGHERID= f'SYSTEM—PROGRAMMER'1'programmer-name* 



i 

I |'identification'}] 



i 

1 T,PREFIX=fCICSIprefix)1 



i 

| [,PRIORTY=nn] 



i 

1 r,PR0CNMS=(DFHASMVS.DFHLNKVS.DFHUPDVS.DFHAOPLK, 



i 

1 DFHSMPVS,DFHEITCL,DFHEITPL,DFHEITAL) 



i 

| |(procedure—names)] 



i 

| [ ,REGION=storage ] 


1- 

•_ 

i_ 

_i 


TYPE=INITIAL 

specifies that this is the initial macro instruction in a 
CIC5/VS system generation run. 
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I 

I 

I 


ACCTID={CICS|accounting—information} 

specifies the job accounting information which is to appear on 
the JOB card of each job generated by stage 1 of CICS/VS system 
generation. The default is ACCTID=CICS. For OS/VS, 
information must not be included within quotes. For further 
details of valid accounting information options, see OS/VS1 JCL 
I Reference or 0S/VS2 JCL . For VSE, the accounting information 

must be included within quotes. For further information about 
| accounting information, see VSE/Advanced Functions System 

Control Statements . 

| For both VSE and 0S/VS, if the accounting information contains 

quotes or ampersands, two quotes or two ampersands must be 
coded for every single one.' 


| ASMBLR= (IFOXQO I ASSEMBLY Iassembler—name) 

specifies the name of the assembler to be used during stage 2 
of system generation and to produce the proper JCL. The 
default is ASMBLR=ASSEMBLY for CICS/DOS/VS, and ASMBLR=IFOXOO 
for cics/os/vs. 


{DLI|DL1} ={NO|REMOTE|string|YES} 

specifies whether the Data Language/I (DL/I) interface is to be 
included in this generation of CICS/VS. The default is DLI=NO. 

| DLI=NO may be specified on any DFHSG invocation to produce non— 

| DLI versions of modules for the group specified. 

This parameter must not be specified if DL/I ENTRY DOS/VS is 
being used, but is required if DL/I DOS/VS or IMS/VS are being 
used. For further information, see "DL/I with CICS/OS/VS" in 
Chapter 2.4. 

NO 

indicates that DL/I support is not required. 

REMOTE (CICS/OS/VS only) 

indicates that the CICS/VS system requires DL/I support, 
but that all the data bases that are to be accessed reside 
on remote CICS/VS systems and are to be accessed through 
| intercommunication support. This option is only required 

if the IMS/VS macro and object module libraries are not 
available when the CICS/VS system is generated. 

DLI=YES must also be specified in DFHSIT or as a startup 
override when DLI=REMOTE is used. The BUFPL, DLTHRED, 

DMBPL, ENQPL, PISCHD, PSB, and PSBPL operands need not be 
specified in DFHSIT. However, an empty DDIR is required, 
together with a PDIR that contains details of remote PSBs. 

string (CICS/OS/VS only) 

is a string in the form n.n.n (where n is a single digit) • 
The string indicates the level of IMS/VS for which 
| CICS/OS/VS support is to be included. DLI=1.1.5 or 1.1.6 

I are the only values that can be specified for CICS/VS 

I Version 1 Release 5. 

YES (ClCS/DOS/VS only) 

indicates that DL/I support is to be included. 

| If either DLI=YES or DLI=string is specified, then DLI=NO 

| may be specified in any DFHSG PROGRAM=group macro 

j instruction to suppress the generation of DLI dependent 

I modules from that group. 
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EJECT = (YES I nl 

specifies the effect of page ejects in the assembly listings of 
the CICS/VS modules. The default is EJECT=YES. 

This operand allows for paper saving by reducing the size of 
the CICS/VS module listings depending on the value chosen for 
"n". This operand has no effect if PRINT=NOLIST is specified. 


YES 

indicates that normal page ejects will occur. 


specifies a number from 1 to 99, which controls the number 
of spaces to be substituted for page ejects. A separator 
line preceded and followed by a M space x 11 statement (where 
x = n—2) will replace page ejects. 


JOBNAME=( CICS Ijobname} 

specifies the first part of a JCL (OS/VS) or job control 
(DOS/VS) jobname for system generations. The default is 
JOBNAME=CICS. The complete jobname is a concatenation of the 
jobname operand (truncated to four characters) plus the three 
characters of the program name, plus any suffix (truncated to 
one character, if necessary, to keep within the limit of eight 
characters). For JOBNAME=NEWRUN, PROGRAM=KCP, and SUFFIX=03, 
the complete jobname would be NEWRKCPO. For the default 
JOBNAME operand, PROGRAM=KCP, and S0FFIX=2, the jobname would 
be CICSKCP2. 

Note ; The program name for DFHSG TYPE=INITIAL is provided by 
the system as GEN. Therefore, the default jobname is CICSGEN. 


MOD= (program, [ suffix ][,...]) 

indicates that the Stage 1 output produced by DFHSG will 
consist only of the jobs for those programs named in this 
operand. All other Stage 2 jobs will be suppressed. Stage 2 
jobs for a program named in this operand will be suppressed 
unless the S0FFIX operand in the appropriate DFHSG PROGRAM-xxx 
macro corresponds to the suffix parameter in the MOD operand. 
This allows APAR fixes to be applied to individual versions of 
the modules produced by DFHSG PROGRAM=xxx macros. 

program 

| is the name of a CICS/VS program (for example, ZCY) . This 

| name refers to the module generated by system generation 

| macros (see Appendix C), and does not refer to the PROGRAM 

| operand of the DFHSG macro instruction. 

I Note ; The name specified must be that of an individual CICS/VS 

| module, and not that of a group. To produce output for a 

| program group, all the module names in that group must be 

| specified. 
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suffix 

is the optional suffix appended to the program. If this 
parameter is omitted, an unsuffixed version of the program 
will be searched for in the Stage 1. If ALL is specified, 
all Stage 1 versions will be dealt with. 

| Appendix C, which lists all modules, should be used to 

| determine whether or not a module is suffixable. A suffix 

| parameter of ALL should not be specified for modules which 

| are not suffixable. 

Note : If the suffix parameter is omitted, a comma must still 

be specified. 

For example: 


DFHSG TYPE=INITIAL,MOD=(KCP,1A,SIA1,,DCP,ALL,PCP,,TRP,2A) 

DFHSG PR0GRAM=KCP,SDFFIX=1A 
DFHSG PROGRAM=KCP,SUFFIX=5A 
DFHSG PROGRAM=CSO 
DFHSG PROGRAM=PCP 
DFHSG PR0GRAM=DCP,StJFFIX=3A 
DFHSG PR0GRAM=DCP,S(JFFIX=4A 
DFHSG PROGRAM=TRP,SUFFIX=2A 
DFHSG PROGRAM=TRP,SUFFIX=6A 
DFHSG TYPE=FINAL 

will produce Stage 1 jobs for: 

DFHKCP1A, DFHSIA1, DFHPCP, DFHDCP3A, DFHDCP4A, 
and DFHTRP2A 

and will suppress Stage 1 jobs for: 

| DFHSPP, DFHKCSP, and DFHALP (from DFHKCP), DFHKCP5A, DFHTRP6A, 

and all the other jobs normally produced by DFHSG PROGRAM=CSO 


OPSYS= fVSil MVS | »DOS/VSE*} 

specifies the environment in which CICS/VS is to operate. The 
default is 0PSYS=VS1 for CICS/OS/VS, and OPSYS= l VSE i for 
CICS/DO S/VS. 

VS1 

indicates that the CICS/VS system is to run under 0S/VS1. 

MVS 

indicates that the CICS/VS system is to run under MVS. 

1 DO S/VSE 1 

provides VSE support for the CICS/DOS/VS system. 


PRINT=([ ( LIST I NO LIST) ][ , fXREF I NOXREF > SHORTXRBF1 ][ , f DSECT I NODSECT 1 
SOMEDSECT} ][ ,DSLIST ]]) 

specifies the printing option for the assembly of the CICS/VS 
modules during stage 2 of system generation. 


LIST 

indicates that the total assembly listing is to be printed. 
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NOLIST 

| indicates that no assembly listing is produced. 

I Note : NOLIST, if specified, overrides all options in the XREF 

| and DSECT groups. 

XHEF 

indicates that the cross-reference list is to be printed. 
NOXREF 

indicates that no cross-reference list is to be printed. 

| SHORTXREF 

indicates that the cross-reference list is to contain only 
symbols that are referenced. 

| DSECT 

indicates that all CICS/VS DSECTs are to be printed for 
each program. 

| NODSECT 

| indicates that none of the CICS/VS DSECTs will be printed. 

| SOMEDSECT 

indicates that the large DSECTs (CSA, TCA, TCTLE, and 
TCTTE) are not to be printed. 

| DSLIST 

I indicates that one listing will be printed of all the 

| DSECTS that are suppressed in each of the generated 

| programs when NODSECT is in force. 


| STAGE2= {FORCE|SELECTIVE} 

specifies whether DFHSG will produce Stage 2 jobs for all 
programs requested. The option specified in this macro sets 
the defaults for the STAGE2 operands of the rest of the system 
generation macros. The default for DFHSG TYPE=INITIAL is 
| STAGE2=SELECTIVE. 


| The STAGE2 operand is not relevant when STARTER=YES is 

| specified. Specification of STARTER=YES implies STAGE2=F0RCE 

| and therefore a DFHGEN HOD= (module list) (CICS/DOS/VS only) or 

| DFHSG TYPE=INITIAL macro with the HOD operand should be used 

| when selectively generating starter system modules. 


| FORCE 

generates the Stage 2 jobs for all system generation 
programs requested, and must be specified if the IBM- 
supplied starter system library is not being used. 

I SELECTIVE 

| indicates that Stage 2 jobs may be selectively suppressed. 

STAGE2=SELECTIVE causes DFHSG to suppress generation of the 
Stage 2 job for any module If a preassembled version of the 
module has been supplied on the CICS/VS starter system 
library. BNOTEs produced during the Stage 1 assembly 
indicate which jobs have been suppressed and which suffixed 
modules must be used in their place, and which have been 
generated. 
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STARTER=YES 

specifies that the generation of starter system modules (with $ 
and # suffixes) is permitted, and various MNOTEs will be 
suppressed. This operand should only be used when service is 
being performed on starter sytem modules. 


VSAM= {YES |N0) 

indicates whether VSAM support is required. The default is 
YES. 

YES 

indicates that VSAM support is required. 

NO 

indicates that VSAM support is not required. This option 
| prevents certain assemblies from searching the VSE or OS/VS 

libraries for VSAM macros. 


VSAMSHR={NO|YES} 

specifies whether the VSAM shared resources option is to be 
used. The default is NO. 

NO 

indicates that VSAM resources are not to be shared. 

YES 

} indicates that VSAM resources will be shared. VSAM=YES 

| must also be specified, or allowed to default. 


VT A M = {YES | NO} 

| indicates whether ACP/VTAM support is required. The default is 

| YES. 


I 


YES 

indicates that ACF/VTAM support is required. 


I 

I 

I 


indicates that ACF/VTAM support is not required. This 
option prevents certain assemblies from searching the VSE 
or OS/VS libraries for ACF/VTAM macros. 


I 


ACF/VTAM support is required if the High Performance Option 
Authorized Path facility is to be used. 


CICS/DOS/VS only 


| DEV ICE = {TAPE 12314|3330 f 3340133501FBA1 

If this parameter is specified, it becomes the default device 
for the keypoint, trace control, and dump control programs. 
Note, however, that DEVICE=TAPE is not allowed for DFHSG 
| PROGRAM=KPP. 
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CICS/OS/VS only 


| CICSSVC=f216 I number) 

| specifies the SVC number to be used for the CICS/V5 bootstrap 

SVC that CICS/VS will provide. This SVC is required if page- 
fixing is to be used; that is, if ANTICPG=YES or ANTICPG=number 
is specified in DFHPCT TYPE=ENTRY, if RES=FIX is specified in 
DFHPPT TYPE=ENTRY, or if FIX=YES is specified in DFHALT 
| TYPE=ENTRY or DFHNLT TYPB=ENTRY. The SVC is also required for 

I the Multi Region Operation (MRO) facility (CICS/OS/VS), the 

| High Performance Option (HPO) (CICS/OS/VS), and the 7770 device 

j end program. The number may be in the range 200 through 255; 

| the default is 216. 

This operand controls the name given to the SVC routine that is 
generated by the DFHSG TYPE=INITIAL macro. 


DEBCHK={YES|NO} 

| applies only to 7770 devices under OS/VS1 or MVS. For OS/VS 1, 

the DEB checking facility is optional and has a default of NO. 

| For MVS, DEB checking is required and has a default of YES. 

DEBCHK=NO can only be specified if there are no 7770 devices on 
| the MVS system. 

YES 

indicates that the DEB validity check facility is 
supported. 


indicates that the DEB validity check facility is not 
supported. 


SRBSVC=number 

| specifies, for OS/VS2 Release 3.8, the type—6 SVC number to be 

used for invoking the service request block (SRB) routine 
provided by CICS/VS. This routine (DFHHPSVC) must have been 
link—edited into the user*s MVS operating system as the 
appropriate SVC number, and is required to obtain access to any 
SRB—dependent functions of CICS/VS (VSAM ICIP support and VTAM 
authorized path). The number specified must be in the range 
| 200 to 255. 

If SRBSVC=number is specified, CICSSVC=number is also required. 


S TA TO S=FI R ST 

is used to cause the CICS/VS cataloged procedures to be placed 
in SYS1.PROCLIB. In CICS/OS/VS, STATOS=PIRST and 
CICSSVC=number generate a job to assemble and link-edit the 
page-fix SVC to SYS1.SVCLIB (OS/VS1) or SYS1.LPALIB (OS/VS2). 
STAT0S=FIRST and SRBSVC=number will generate a job to assemble 
and link-edit the CICS/OS/VS SRB SVC (DFHHPSVC) into the 
CICS/OS/VS load library. 

STAT0S=FIRST must be used with each new release to obtain the 
latest cataloged procedures. If TCT0A=V1C0MPAT is specified, 
jobs are created that modify the DFHTCT macro instruction and 
DFHTCT symbolic storage definition (DSECT) to provide upward 
compatibility from CICS/OS—STANDARD Version 1. 
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TCTUA= (VARIABLE |V1COM PAT} 

specifies user—defined process control information (PCI) fields 
of fixed length (15 bytes) and/or variable length (0 to 255 
bytes). These fields are located in the terminal control table 
and can be used as terminal work areas. The default is 
TCTOA=VARIABLE. 

VARIABLE 

specifies a variable—length (byte-aligned) PCI field (the 
address of which is at TCTTECIA and the length of which is 
at TCTTECIL) and must be used by all but CICS/OS—STANDARD 
Version 1 users (who have used PCI fields) if a terminal 
work area is needed. 

V1C0MPAT 

should only be used by users of earlier versions of 
CICS/OS/VS who are currently using the fixed—length 15-byte 
PCI field (the address of which is at TCTTECI) and who need 
PCI compatibility with CICS/OS—STANDARD Version 1. This 
option must be specified in conjunction with the 
STATUS=FIRST operand. 

Note: If this option is specified, use of the preassembled 

| starter system cannot be guaranteed. In addition, any 

I module that has a reference to the TCTTE must be 

| reassembled. 


OS/VS JCL Options 


The following JCL options may be required for generation of the 
CICS/OS/VS system. For further details refer to the OS/VS1 JCL 
Reference or OS/YS2 JCL manuals. 

Note : Values for the parameters relating to OS/VS JCL options are not 
edited by CICS/VS. Any errors will not be apparent until Stage 2. 


CLASS=jobclass 

is used to assign a jobclass to all Stage 2 jobs. 


CONDCD= (code,operator,...) 

specifies the condition codes which, if met on any job step, 
cause further processing of that job to be bypassed. 


MSGCLAS=x 

is used to route all messages issued by the OS/VS Job Scheduler 
to an output class. 


MSGLVL= (01112} 

specifies the message level desired for the JCL during Stage 2. 
The default is HSGLVL^O. 


PGMERID= f'SYSTEM—PROGRAMMER 1 1'programmer-name *|'identification'} 

specifies the programmer's name to be placed in the JCL. The 
default is PGMERID='SYSTEM—PROGRAMMER*. 
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PREFIX*{CICS|prefix} 

specifies the index name for CICS/VS system data sets. The job 
control language (JCL) generated specifies these data sets as 
prefix.LOADLIB, prefix.MACLIB, and prefix.SOURCE, where 
■•prefix” must conform to the data set naming conventions. The 
default is PREFIX=CICS. 


PRIORTY=nn 

is used to assign a priority to the jobs in Stage 2 of system 
generation. All jobs are given the same priority. 


PROCNMS=procedure—names 

allows the user to specify the names of CICS/VS cataloged 
procedures to be used as follows: 

1. First Name — assembly of CICS/VS programs and user—written 
assembler language programs. 

2. Second Name — link edit of CICS/VS programs and application 
programs. 

3. Third Name — update of a temporary library during system 
generation. 

4. Fourth Name — assembly and link edit during the preparation 
of system tables. 

5. Fifth Name — the procedure used to execute the system 
modification program. 

6. Sixth Name — translate, compile, and link edit ANS COBOL 
application programs using the command—level interface. 

7. Seventh Name — translate, compile, and link edit PL/I 
application programs using the command—level interface. 

8. Eighth Name — translate, compile, and link edit assembler 
application programs using the command—level interface. 


The default names are: 

PROCNMS* (DFHASMVS,DFHLNKVS,DFHUPDVS,DFHAUPLK,DFHSMPVS,DFHEITCL, 
DFHEITPL,DFHEITAL). 


REGION=storage 

allows the user to specify the maximum amount of storage to be 
allocated to the Stage 2 jobs. 

If REGION=nK is specified (for example, REGION=52K), ”n” 
indicates the number of 1024—byte areas of virtual storage to 
be allocated for the job (••n 11 must be an even number) . 

If this operand is omitted, the default value (as established 
in the input reader procedure) is assumed. 
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ATP — ASYNCHRONOUS TRANSACTION PROCESSING PROGRAM 


The asynchronous transaction processing (ATP) facility for reading batch 
input from a device, storing it in a queue, processing the input, and 
then writing it out to another device, is designed specifically for 
handling input from batch terminals such as the 2770, the 2780, or the 
3780. Generally, ATP can also be used from other interactive terminals, 
like the 2741. However, ATP is not intended for, and will not support, 
input from the 3270, 2980, 3740, 3735, or from any logical unit. 

The system generation macro instruction necessary to generate the 
asynchronous transaction processing program is DFHSG PROGRAM=ATP. 

The following programs are generated in response to this macro 
instruction: 

• Asynchronous transaction control program (DFHATP) 

• Asynchronous transaction input processing programs (DFHRD1 and 
DFHRD2) 

• Asynchronous transaction output processing programs (DFHWT1 and 
DFHNT2) 

• Asynchronous queue purge program pFHAQP) 

For information on the control statements that are needed when the 
asynchronous transaction processing facility is used, refer to the 
CICS/VS Operator*s Guide . 


-1 

* I 

♦ I 

_i 


* See the first page of this chapter. 


| | DFHSG | PROGRAM=ATP 

| | | [ ,STAGE2={SELECTIVE(FORCE) ] 


3FP — BUILT-IN FUNCTIONS PROGRAM 


The built-in functions program (DFHSG PROGRAM=BFP) is generated with two 
options; the basic function and the weighted retrieval function. These 
options may be specified separately or together through the BUILTIN 
operand. The facilities provided in the basic function are: 

• Table search 

• Verification of a data field — verify alphabetic or numeric 

• Editing of a data field — removing unwanted characters 

• Phonetic conversion 

• Bit manipulation 

• Input formatting 

The weighted retrieval function allows the user to search a specified 
group of records on a VSAM data set and to select only those records 
that satisfy specified criteria. 
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i-r 


IDFHSG 

| PROGRAM=BFP 

♦ 



1 f,BUILTIN=f(BASIC,WTRET) 1 (BASIC 1WTRET11 1 




| [,DUHMY=YES ] 

♦ 



| [,ST&GB2={SELECTIVE|FORCE}] 

* 



| [,SUFFIX=xx] 

♦ 



i_i___ _ _ j 


♦ See the first page of this chapter. 


BUILTIN={(BASIC^WTRET)|{BASIC|WTRET}} 

specifies which of the built-in function options is desired. 
The default is both functions (BASIC,WTRBT). 

BASIC 

generates the basic function. 

WTRET 

generates the weighted retrieval function. 


N otes : 

1. For CICS/OS/VS, generation of the built-in functions program causes 
the phonetic code conversion subroutine (DFHPHN) to be generated. 
This offline subroutine provides the facility to convert a 16- 
character name to a 4—byte phonetic code. See the f, Built—In 
Function" macro instruction DFHBIF TYPB=PHONETIC in the CICS/VS 
Application Programmer*s Refere n ce Manual (Macro Level) for the 
rules of the conversion. 

2. The field-separator and field—name start characters facilitate the 
input formatting function. The field-separator characters are 
specified by the FLDSEP operand of the DFHSIT macro instruction. 

The field-name start character is specified by the FLDSTRT operand 
of the DFHSIT macro instruction. 


BMS - BASIC HAPPING SUPPORT PRO GRAH 


All BMS functions are generated by the basic mapping support program 
(DFHSG PROGRAM=BMS). If the BMS program with PAGING or ROUTING is 
specified, the temporary storage program is also necessary. The 
programs that may be generated in response to the parameters in the 
DFHSG PROGRAM=BMS macro instruction are: 


• DFHMCP — Mapping control program 

• DFHMCE — Entry Level System 

• DFHPBP — Page Build program 

• DFHIIP — Non—3270 input mapping 

• DFHTPP — Terminal page program 

• DFHM32 - 3270 mapping 

• DFHDSB — Data stream builder 

• DFHRLR — Route list resolution 

• DFHTPQ — Terminal page clean—up 
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I 


DFHTPP - 

Terminal page program 

DFHTPR - 

Terminal page retrieval 

DFHTPS - 

Terminal page scheduling 

DFHFIP - 

Faster 2260 compatibility 

DFHF2P - 

Faster 2260 compatibility 

DFHBMSMM - 

Pre—VS BMS mapping module 


t The suffix specified in the SOFFIX=xx operand is appended to all 
| programs generated except DFHBMSMM, DFHTPQ, DFHTPR, and DFHTPS. 

When requesting BMS to be included in the system during CICS/VS 
generation, considerable flexibility is provided to tailor the amount of 
support included. By choosing only the functions required for a 
particular installation, the size of the working set for the system can 
be significantly reduced. 
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[ ,BMSCPYC={YBS|NO}] 
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[,BMSDDS = {N0|YES} ] 
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[,BMSTAB={NO|YES} ] 
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| * See the first page of this chapter. 

| Note s; 

| 1. The PRGDLAY operand is no longer applicable to DFHSG PROGRAB-BMS, 

| but may be specified on the DFHSIT macro. Refer to Chapter 3.2 of 

| this manual for a description of the DFHSIT macro. 

2. To use the message switching facility, basic mapping support must 
| be generated with BMSTXB=YES (or allowed to default), ROUTING=YES, 

PAGING=YES, and, if 3270 terminals are involved, MAP3270=YES. 
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| 3. To use BMS paging in conjunction with transaction routing, 

| BMSTXB=YES must be specified or allowed to default. 


BMSCPYC={YES|NO) 

specifies whether the BMS copy command routines should be 
generated. If NO is specified, copy commands must not be 
defined in the DFHSIT macro. Refer to the relevant notes under 
the BMSDE? and MAPHC operands, which follow, for instances of 
when the BMS copy command should be used. BMSCPYC defaults to 
the same option as specified in the ROUTING parameter. 

Note ; The BMS copy command is independent of the copy 
functions provided for certain terminals by TCP and by the ZCP 
modules• 


BMSDDS={YES| NO} 

specifies whether support for device-dependent mapset suffixes 
is to be generated. The default is YES. 

YES 

indicates that support for device-dependent mapset suffixes 
is to be generated. If this parameter is specified, BMS 
will attempt to load device-dependent mapsets in preference 
to device—independent mapsets. 

NO 

indicates that support for device—dependent mapset suffixes 
will be deleted. If this operand is specified, TERM=ALL or 
TBRM=3270 must be generated in the DFHMSD macro for all 
mapsets. 


| BMSDEV= (device,...) 

specifies the devices for, which BMS support is to be included. 
Generation of 3270 routines is controlled through either the 
BMSDEV=3270 or the MAP3270 operands. 


CRLP card reader/line printer 

TAPE magnetic tape 

DISK sequential disk 

TWX CPT-TWX (Model 33/35) 

1050 1050 terminal 

2740 2740 terminal (without receive buffer) 

2740BR 2740 terminal (with receive buffer) 

2741 2741 terminal, including read attention and 
write break (OS/VS only) 

2770 2770 terminal 

2780 2780 terminal 

2980 2980 terminal, models 1, 2, and 4 

3270 3270 terminal 
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3601 


3601 terminal support for all devices, except the 3614, 
using VTAM 

3650UP 3650 User Program (3650 Interpreter) 

3653 3653 attached to 3650 

3650/3270 3270 attached to 3650 

3780 3780 terminal 

BCHLU batch logical unit (includes 3770 and 3790 

batch data interchange, and LUTYPE4 logical units) 

3770B 3770 Data Communications System as batch 

logical unit 

INTLU interactive logical unit (flip-flop and contention modes) 

3767 3767 terminal as interactive logical unit 

37701 3770 Data Communications System keyboard/printer 

as interactive logical unit 

SCS 3767, 37701, INTLU, 3767C, 3770C, 3790 SCS 

printer (SESTYPE=SCSPRT), SCS printer (TRBTYPB=SCSPRT), 
and 3790 full function (SESTYPE=USERPROG) logical units 

For DFHTCT TYPE=LINE,TRBTYPB=TCAH, code CRLP 

• When the BBSDEV operand is omitted, support for all of the 
above devices is included by default. 

• Sfhen the BBSDEV operand is specified, device support is 
generated only for those devices specified. 

• If BAP3270=YES and BBSDEV=3270 and all other parameters are 
specified as NO, or defaulted to NO, a special version of 
BBS is generated. This version of BBS supports 3270 
mapping only . 

• If the BBSDEV operand is specified with one or more of the 
above parameters (excluding 3650/3270 and 3270), BAPHC=YES 
must also be specified if mapping support is required for 
these non—3270 devices. 

• If BBS is generated with BAP3270=YBS and HAPHC=YES, and the 
CICS/7S message switching transaction (CBSG) or the BBS 
copy command (to print messages on a 3275 printer, or on a 
3270 display with the printer—adapter feature) are 
reguired, line printer support must be generated by 
specifying the BBSPROP=YES operand. This specification is 
also required if logical messages are to be built for those 
printers that use NLEOB. 

• BCHLU is equivalent to specifying 3770B 

• INTLU, 3767, 37701 and SCS are synonyms in DFHSG 

PROGRAB=BBS. INTLU may be applied to both 3767 and 37701, 
which may also be specified separately with identical 
results. 

• If batch logical units are to be supported by BBS, the 
batch data interchange program (DFHSG PROGRAB=DIP) must be 
generated. 
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• BMSDEV=3270 includes 3270 with TCAM support, 3270 with VTAM 
support, and 3270 compatibility mode. 

• For TCAM SNA logical units, the BMSDEV operand must specify 
the unique device type for device—dependent mapping. 


BMSDIAG=( NORMAL I EXTENDED|MIN} 

indicates the degree of internal checking to be performed by 
BMS diagnostics. The default is NORMAL. 

NORMAL 

specifies generation of all routines necessary to generate 
all documented return codes and transaction anends. 

EXTENDED 

can be used to generate diagnostics, in the form of trace 
table entries, which may be useful when testing new or 
changed application programs or investigating suspected 
problems in BMS code. These traces are documented in the 
trace section of the appropriate CICS/YS Application 
Programmer*s Reference Manua l. 


MIN 

specifies generation of minimum error checking, a subset of 
error checking normally performed by BMS. Use of this 
option should be considered very carefully and then used 
only with stable and well tested application programs. 

This option deletes routines intended to detect errors and 
protect the online system and can be used to reduce virtual 
storage requirements and improve performance. 

Note: This option must not be used when testing new or changed 

application programs, or when investigating suspected errors in 
CICS/VS code. 


BM S DR T= (O gi NO) > 

whether routines to process BMS return requests ate 
to be generated. If NO is specified, DFHBMS TYPE=RETURN or 
EXEC CICS SEND requests with the SET option are invalid* The 
default is YES. 


BMSFMP= (NO | YES} 

indicates whether routines will be generated to accept 
parameters from DFHBMS macros for inclusion in the function 
management header. The routines will be sent to logical units 
that also have BMS FEAT=FMHPARM coded in the DFHTCT 
TYPE=TERMINAL macro instruction. The default is NO. 

NO 

indicates that support for function management header 
parameters (except for outboard formatting, which is 
controlled by the BMSOBF specification) will be deleted. 
FMHPARM options of BMS are ignored, unless used for 
outboard formatting, if BMSFMP=N0 is specified or 
defaulted. 

YES 

indicates that specified routines will be generated. 
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BMSFRL={YES|NO} 

specifies whether routines to perform field relocation will be 
generated. These routines are needed if the SIZE operand of 
DFHMDI macros specifies a map with less than the page width 
defined in the terminal entry. Field relocation is also used 
if the map origin, as specified by the line and column 
parameters of DFHMDI, is other than line one, column one. The 
default is YES. 

YES 

indicates that routines to perform field relocation will be 
generated. BMSFRL=YES is required if BMSPB=YES is coded or 
defaulted. 


indicates that routines to perform field relocation will be 
deleted. 


BMSMBD= {YES | NO} / 

specifies whether BMS mapping routines for handling maps with 
DATA=BLOCK specified will be included. The default is YES. If 
NO is specified, maps and map sets that have DATA=BLOCK 
specified in DFHMSD or in DFHMDI macros are invalid. 
COMPAT=F2260 requires BMSMBD=YES to be specified or defaulted. 


BMSNL={<|character} 

specifies the character that represents the new-line (NL) 
character (end of a logical line) in all messages to and from a 
3270 terminal operating in FASTER 2260 compatibility mode 
(COMPAT=F2260). The character chosen has the same restrictions 
as for the BMSSMI operand (see below) . The NL character also 
remains constant for the entire system. The default is BMSNL=< 
(X^C*) . 

Note : The former user of the FASTER program product will recognize the 
BMSMBD and BMSNL parameters as equivalent to the DFTERM parameters: SOM 
and NL. However, unlike the FASTER operating environment, the 
characters chosen remain constant for all terminals. If operating using 
the FASTER Language Facility, no modification is necessary to the data 
| as formatted by the TPD (Transaction Processing Description) . 


BMSPB= {YES |NO} 

specifies whether BMS page building routines will be included. 
The default is YES. If NO is specified, DFHBMS-PAGEBLD and 
OFLOW=address requests are invalid. COMPAT=F2260 requires 
BMSPB=YES to be specified or defaulted. 


BMSPGO={YES|NO} 

specifies whether BMS pageout routines are to be included. The 
default is YES. If NO is specified, DFHBMS TYPE=PAGEOUT or 
EXEC CICS SEND PAGE requests are invalid. 

Pageout routines are not required if R0UTING=N0, PAGING=N0, 
BMSPB=N0, and BMSTXB=N0 are all specified. COMPAT=F2260 
requires BMSPGO=YES to be generated or defaulted. 
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BHSPRG={YES|NO} 

specifies whether BHS purge routines are to be included. The 
default is YES. If NO is specified, BHS purge operations 
reguests are invalid. 

Purge routines are not required if ROUTING=NO, BHSPB=NO, 
BMSTXB=NO, and PAGING=NO have been specified, or if application 
programs never issue BHS purge requests. COHPAT-F2260 requires 
BMSPRG=YBS to be specified or defaulted. 


BHSPROP= {NO | YES} 

indicates whether the necessary printer support to handle NLEOK 
requests from 3270 printers will os generated. The default is 
NO. 


NO 

indicates that printer support is not required. 

YES 

indicates that 3270 printer support for NLEOH requests will 
be generated. If this option is specifie&, MAPHC=YES, 
HAP3270=YES, and BHSDEV=CRLP need not be specified. 


BHSRCVR= {NO | YES} 

specifies whether routines to participate in the recovery of 
routed or non—routed messages are to be generated. The default 
is NO. 

NO 

indicates that all BHS routines, which participate in the 
recovery of routed and non—routed messages, are to be 
deleted. 3MS will still honor and use the REQID 
specifications specified by the user because this does not 
necessarily imply recovery. 

YES 

indicates that BHS routines to participate in the recovery 
of routed and non—routed messages will be generated. 
However, BHS recovery requires the interval control program 
and the temporary storage program. 


BHSSHI=fcicharacter} 

specifies the character that represents the start—of—message 
indicator (SHI) in all messages to and from a 3270 terminal 
operating in FASTER 2260 compatibility mode (COHPAT=F2260). 

The default is BHSSHI=- (X , 4A i ) . The character chosen must be 
a valid alphanumeric character (excluding the following: • = , 
& and blank) and must be present on the 3270 keyboard. If the 
SHI is contained in an output data stream, its display is 
dependent upon the language feature specified for the 3270 
terminal. Whichever character is chosen remains constant for 
the entire system. 
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BMSTAB={NO| YES} 

specifies whether tab support is required. The default is 
BMSTAB=NO. If NO is specified or defaulted, the HTAB=(tab,•••) 
and VTAB= (tab,•••) parameters in the DFHMSD macro instruction 
cannot be used; specifying VTAB and HTAB will cause the 
transaction to be abnormally terminated, and the DFHMSD map 
definition will be ignored. 

BMSTAB can be specified for TCAM supported devices if 
ACCMETH=TCAM and TRMTYPE=TCAM are specified in DFHTCT 
TYPE=LINE• 


BMSTXB={YES|NO} 

specifies whether BMS text building routines are to be 
included. The default is YES. If NO is specified, BMS text 
building requests and the following operands are invalid: 
HEADER, TRAILER, and JUSTIFY. BMSTXB=YES must be specified or 
allowed to default if message switching support or transaction 
routing in conjunction with BUS paging is required. 


COMPAT={PRE-VS|F2260} 

specifies whether either of the compatibility features is to be 
generated. 

PRE-VS 

indicates that the user intends to use maps that have not 
been recompiled or reassembled under CICS/VS. MAP3270=YES 
must be specified for COMPAT=PRE-VS. 

Note ; Pre—VS application programs must be re—assembled. 
F2260 

indicates that the user intends to operate non—VTAM 3270 
terminals in FASTER 2260 compatibility mode. COMPAT=F2260 
requires MAP3270=YES, MAPHC=YES, BMSMBD=YES, BMSPB=YES, 
BMSPGO=YES, and PAGING=YES. 


MAP3270={YES|NO} 

specifies whether BHS will support the 3270 Information Display 
System. The default is MAP3270=YES. MAP3270=YES or 
BMSDBV=3270 is required for BMS support of the 3270. 

YES 

indicates that support for the 3270 will be generated. 

NO 

indicates that support for the 3270 will not be generated. 


MAPALGN={NO| YES} 

specifies whether BMS will support halfword—aligned or 
unaligned length fields in input maps (that is, those generated 
using the DFHMSD macro with MODE=IN or INOUT). The default is 

MAPALGN=N0• 

NO 

indicates that BMS will not expect the length fields in 
input maps to be aligned. 
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YES 


indicates that BUS will expect the length fields in input 
maps to be halfword-aligned. Por the required changes to 
the JCL, see the appropriate CICS/VS System Programmer»s 
Guide (DOS/VS or OS/VS) . 

I Note : If alignment of length fields is not required (that is, 

| for compatibility with existing maps), then MAPALGN=HO should 

| be specified. 


{NO|YES} 

indicates whether the BUS hard copy mapping function is 
required for non—3270 devices that are specified in the BMSDEV 
operand. MAPHC=YES must be specified for 3270 devices with the 
printer-adapter feature when new—line-character support is 
required. The default is MAPHC=NO. 

NO 

indicates that the BBS hard copy mapping function will not 
be supported for these devices. 

YES 

indicates that the BMS hard copy mapping function will be 
supported for these devices. 

Notes : 

1. If BMS is generated with MAP3270=YES and MAPHC=NO, and a 
logical message is built for a 3270 printer or for a 3270 
display with the printer—adapter feature using BMS requests 
that specify the PRINT option, the contents of the entire 
3270 buffer will be printed, regardless of the length of 
the message. 

2. The BMSDEV operand must be specified if: 

— BMS is generated with MAP3270=YES and MAPHC=YES, and 
the CICS/VS message switching transaction (CMSG), or 
the BMS copy command to print messages on a 3270 
printer or on a 3270 display with the printer—adapter 
feature, are required, and/or 

— if building of logical messages for these printers 
using the NLEOM option of the BMS macro is required. 

Alternatively, the BMSPROP=YES option may be used 
instead of MAP3270=YES, MAPHC=YES, and BMSDEV=CRLP. 

See also the notes under the BMSDEV operand. 


PAGING={N0| YES} 

specifies whether pages can be stored on temporary storage 
prior to their retrieval. The default is PAGING=N0• In order 
to use paging, temporary storage support is required. If 
PAGING=YES is specified, AUTOTRN=YES must be specified in DFHSG 
PROGRAM=TCP. 

NO 

indicates that paging will not be supported. 

YES 

| indicates that paging will be supported. 


MAPHC= 

I 

I 

I 

I 
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ROUTING^{NO|Y ES} 

indicates whether messages can be routed to a destination other 
than the originating terminal and/or to multiple destinations. 
The default is ROUTING=NO. If ROUTING=YES is specified and the 
user wants to put messages to temporary storage (see DFHBMS 
TYPE=STORE or the PAGING option in the appropriate CICS/VS 
Application Programmers Reference Manu al) , the user must also 
specify PAGING=YES. The BUS macro forces PAGING=YES if 
ROUTING=YES is specified. 

NO 

indicates that routing will not be supported. 

YES 

indicates that routing will be supported. AUTOTRN=YES must 
be specified in DFHSG PROGRAM=TCP. 


SKR3270={NO|YES} 

specifies whether single keystroke retrieval is required. The 
default is NO. 

SKR3270=YES requires that MAP3270=YES and PAGING=YES are also 
specified or defaulted. If not specified, they are forced to 
YES and the user is informed. 


CSA - COMMON SYSTEM AREA 


The system generation macro instruction necessary to generate the common 
| system area is DFHSG PROGRAM=CSA. 

In addition to generating the CSA, the execution of this macro 
instruction causes the assembly of terminal control*s TCA, task 
controls TCA, and, in CICS/DOS/VS, a write—to-operator (WTO) routine. 

| Note : The SUFFIX operand is valid only for CICS/OS/VS. 


i-1-1- 

| | IDFHSG | PROGRAM=CSA 

|| | | [,SUFFlX=xx] (CICS/OS/VS only) 

i-1-1--- , , - 


| * See the first page of this chapter. 



CSD — CONTROL SYSTEM DUMMY GROUP 


If a particular CICS/VS management program (for example, the file 
control program) is not required, the user need not generate that 
program and, as a result, can save the amount of virtual storage that 
would be reguired to contain the program. However, a dummy program must 
be provided for every CICS/VS management program not actually generated. 

When the control system dummy group is generated in response to the 
DFHSG PROGRAM=CSD macro instruction, dummy programs with tne suffix W DY M 
are produced for the following programs: 

• File control program 

| • DL/I interface program (CICS/OS/VS only) 
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| • Monitoring program 

• Trace control program 

• Batch data interchange program 

• Transient data control program 

• Dump control program 

• Temporary storage control program 

• System recovery program 

• Basic mapping support program 

• Journal control program 

• Built-In functions program 

• Keypoint program 

| • Security program 

This facility allows all of the above dummy programs to be generated 
without generating each one separately. 

« • i * 

| | |DFHSG | PROGRAM=CSD * I 

|| | | [,STAGE2={SELBCTIVE|FOBCE}] * | 

I ii» . » 

j * See the first page of this chapter. 


CSO — CONTROL SYSTEM OPERATIONAL GBOOP 

The system generation macro instruction necessary to generate the 
control system operational group is DFHSG PROGRAH=CSO. The following 
modules are generated in response to this macro instruction: 

| • User exit interface: user exit handler (DFHUEH) and user exit 

| manager (DFHUEH) 

| • CICS/TS monitoring program (DFHCMP), monitoring start/stop program 

| (DFHCMON), and periodic monitoring program (DFHCCMF) 

• System initialization program (DFHS1P) and its overlays 

• System termination program (DFHSTP) 

• Abnormal condition program (DFHACP) 

| • Console write—to-operator program (DFHCWTO) — VSE only 

• Terminal abnormal condition program (DFBTACP) 

• LIFO storage program (DFHLFO) 

• Error message program (DFHHGP) 

• Error message table (DFHMGT) 
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| • Intercommunication facilities link statistics program (DFBSTLK) 

• A dummy terminal error program (DFBTEP). A sample DFBTEP is also 
provided. (See "Generating the Sample Terminal Error Program" in 
Chapter 4.2.) 

• Time adjustment program (DFHTAJP) 

• File and terminal statistics program (DFBSTTR) 

• Supervisor statistics programs (DFBSTKC) 

• Formatted dump program (DPHFDP) and its subprograms. Note that if 

| a SNAP dump is not reguired for ASRA interrupts or ASRB abends when 

FDP=SNAP or FULL is specified in DFBSIT, the two assembler comment 
lines at label FDASNAP in this module must be replaced by the code 
as noted in the comment, before running the CICS/VS system 
generation. 

• Automatic statistics summarization control program (DFBSTSP) 

• Data management statistics program (DFBSTTD) 

• Program and dump statistics program (DFBSTPD) 

| • 7770 read/write program (DFHRWP70) — CICS/OS/VS — if, and only if 

| the CAA operand is specified. 

| • 7770 channel/abnormal end appendage program (IGG019zz where zz is 

| the value specified for the CAA operand) — CICS/OS/VS only, and 

| only if the CICSSVC and CAA operands are specified. 

| • 7770 device end program (DFBDBB70) — CICS/OS/VS only, and only if 

I the CICSSVC and CAA operands are specified. 

| • IRC STAB exit (DFBCRC) - CICS/OS/VS only. 

• DL/I interface program (DFBDLI) — CICS/OS/VS only. 

| • DL/I application program (DFBDLQ) — CICS/OS/VS only. 

• A dummy program error program (DFBPBP). 

• Message switching program (DFBMSP) — To use this, basic mapping 
support must be generated with ROUTING=YES, PAGING 3 YES, and, if 
3270 terminals are involved, MAP3270=YBS, BMSPGO=YES, and 
BBSTXB~YES. Refer to the notes under the BMSDEV and MAPBC operands 
of DFBSG PROGRAM=BMS. In addition, the temporary storage control 
program is reguired. 

| • Direct Access Logic Module (DFBSDAM) — CICS/DOS/VS only 

| , • System dump program ($$BDFBDP) — CICS/DOS/VS only. 

| • The online facility error recognition system (FERS) programs, 

| DFBFED1, DFHFED2, DFBFELG, DFBFERR, and DFHFETX - CICS/DOS/VS only. 

Note ; To bypass the automatic statistics program normally generated by 
| DFBSG PROGRAM=CSO, the following program may be assembled and link— 

| edited to the CICS/VS library to replace the DFBSTSP module generated 
during system generation. 
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DFHCOVER 
COPY DFHCSADS 
COPY DFHTCADS 
OPFLREG EQU 10 

RC11 EQU X'11' 

DFHSTSP CSECT 

USING CSAOPFL,OPFLREG 
L OPFLREG,CSAOPFLA 

MVI CSASTSRC,RC11 

DFHPC TYPE=RETURN 
END 


OPTIONAL FEATURES LIST BASE 
RETURN CODE - MO AUTO STATS SUPPORT 


LOAD OPTIONAL FEATURES LIST ADDRESS 
INDICATE NO AUTOMATIC STATISTICS 
DFHSTKC HILL ISSUE MESSAGE 


When using this program, only the PPT entry for DFHSTSP is required; 
automatic statistics table entries for DCT and PCT are not required. 
The following message will be printed if an attempt is made to 
communicate with the program: 

| DFH1822 AUTOMATIC STATISTICS NOT SUPPORTED 


I 

I 


I 


DFHSG | PROGRAM=CSO * 

| [ ,STAGE2={SELECTIVE|FORCE) ) * 

I 

| CICS/OS/VS Only 

I 

| [ ,CAA=appendage—suffix] 

| [,TCAMSIP=YBS] 

| [,VlCMPAT={NO|YES) ) 


| * See the first page of this chapter. 


CICS/OS/VS Only 


CAA=appendage—suffix 

specifies the two-character alphanumeric suffix to be assigned 
to the 7770 channel end/abnormal end appendage routine provided 
by CICS/VS when that routine is link-edited to SYS1.SVCLIB in 
| OS/VS 1 or SYS1.LPALIB in OS/VS2. The suffix specified must be 

in the range WA to Z9. This operand is required if the 
ACCMETH=BTAM and BTAMDEV=7770 operands are included in DFHSG 
PROGRAM=TCP, and if the APPENDG operand is included in DFHTCT 
TYPE=SDSCI. For information on adding appendages to the 
operating system, see OS/VS1 Data Management for System 
I Programmers or OS/VS2 System Program Library: _ Data Management . 


TCAMSIP=YES 

generates TCAM support in the system initialization program. 


| V1CMPAT={NO|YES) 

must be specified if the user wishes to have the terminal 
abnormal condition program (DFHTACP) provide a CICS/OS Version 
1 interface when linking to the user—written terminal error 
program (DFHTEP) under CICS/OS/VS. This operand is to be used 
only by those former CICS/OS Version 1 users who have an 
| existing DFHTEP. The default is V1CMPAT=NO. 
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CSS — CONTROL SYSTEM SERVICE GROUP 


The system generation macro instruction necessary to generate the 
control system service group is DFHSG PROGRAM=CSS. The programs 
generated by this macro instruction are as follows: 

• Sign-On program (DFHSNP) 

• Sign-Off program (DFHSFP) 

• F.E. terminal test program (DFHFEP) 

| • User identification program (DFHACEE) 

| • Security program (DFHXSP) 

I • RACF Interface program (DFHXSS) (MVS only) 


| | |DFHSG | PROGRAM=CSS * 

|| | | [,DUMMY=YBS] * 

|| | | [ # STAGE2= {SELECTIVE |FORCE} ] * 

i_i_i.,...^ -. . 


| * See the first page of this chapter. 

I Note : If the DUMMY=YES operand is specified, only a dummy version of 
| module DFHXSP will be created. 


CSU — CONTROL SYSTEM UTILITY GROUP 


The system generation macro instruction necessary to generate the 
control system utility group is DFHSG PROGRAM=CSU. The following 
programs are generated: 

• Dump utility program (DFHDUP) 

• Automatic statistics summarization utility program (DFHSTUP) 

• Trace utility program (DFHTUP) 

Support for all device types is generated in this program. Specific 
device types may be selected at execution time. For further details, 
refer to the CICS/VS System Programmers Guide (DOS/VS ) . 


| | | DFHSG 

I I I 

i « 


| PROGRAM=CSU 

| [,STAGE2={SELECTIVE|FORCE}J 


♦ See the first page of this chapter. 
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DBP — DYNAMIC TRANSACTION BACKOPI PROGRAM 


The function of the dynamic transaction backout program is to back out 
the effects of a single in-flight transaction that terminates 
| abnormally, and to restore protected resources, altered by the 
transaction that failed, to the state they were in before the 
transaction started. This feature operates while the rest of the 
CICS/VS system is functioning normally, and not, as in the case of the 
transaction backout program, when emergency restart is invoked after 
| CICS/VS is unable to terminate normally. 

| The programs generated by this macro instruction are: 

| • Dynamic backout program (DFHDBP) 

| • Betry exit program (DFHRTY) — CICS/OS/VS only. 


i -»- 1 - 1 


1 

1 

| DFHSG 

| PROGRAM=DBP 

* 

1 

1 

1 

1 

| [ , {DLI|DL1} = {YES|NO} ] 


1 

1 

1 

1 

| [,STAGE2={SELECTIVE|FORCE}] 

* 

1 

1 

1 

1 

| [,SUFFIX=xx] 

* 

1 


i_i_i_i 


| * See the first page of this chapter. 


| {DLI|DL1} = {YES | NO} 

indicates whether DL/I support is required for this program, 
and can be used to override the option specified in DFHSG 
| TYPE=INITIAL. DLI or DL1=YES cannot be specified in 

| CICS/OS/VS. If DLI or DL1=N0 is specified, a dynamic 

j transaction backout program without DL/I support will be 

| generated, regardless of the DL/I option specified in DFHSG 

| TYPB=INITIAL. 


DCP — POMP CONTROL PROGRAM 


The system generation macro instruction necessary to generate the dump 
control program is DFHSG PROGRAM=DCP. 

Note : In CICS/DOS/VS, Stage 2 jobs will always be produced for this 

program. 


I 

I 

I 

I 


I 


| |DFHSG | PROGRAM=DCP * 

| | | [,DUMMY=YES] * 

| | | [,STAGE2= {SELECTIVE|FORCE} ] * 

| | | [,SUFFIX=xx] * 

I I I 

I I I CICS/DOS/VS Only 

III 

I I I r.DEVADDR= fOIQ Innn}1 


| | I [,DBVICE={TAPE|2314|3330|3340|3350|FBA}] | 

i_i_i_i 


| * See the first page of this chapter. 
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CICS/DOS/VS Only 


DEV ADDR= f 0101nnnl 

| specifies, for DEVICE=TAPE only, the VSB device address to be 

assigned to the tape drive. The address must be a three-digit 
decimal number with leading zeros, if necessary. For example, 
if SYS008 is the device address to be used, DEVADDR=008 must be 
specified. The default is DEVADDR=010. If the DEVICE operand 
is used, the DEVADDR value is picked up from the label 
information supplied for the dump control data set. 


DEVICE^(TAPE 123141 33301334013350 IFBA1 

specifies the type of output device. A particular dump control 
program in CICS/DOS/VS will support only one type of output 
device. If different device types are required on different 
runs, more than one dump control program must be generated 
| using the SUFFIX=xx operand. The default is FBA unless 

overridden by the DEVICE operand of DFHSG TXPE=INITIAL. 


DIP — BATCH DATA INTERCHANGE PROGRAM 


The batch data interchange program, which is generated by DFHSG/ 
PROGRAM=DIP, supports data communication between application programs 
running under CICS/VS and logical units such as the 6670, 3770, and 3790 
batch data interchange logical units. 

In addition, the batch data interchange program provides data 
management functions used with the 6670 logical unit, the 3790 batch 
controller function, and the 3770 batch data interchange logical unit. 

The batch data interchange program must also be generated when a 
batch logical unit requires BMS features. 


1 

1 

i - r 

(DFHSG | 

PROGRAM=DIP 

* 

i 

1 

1 

1 

i i 

[ ,D0MHY=YES] 

* 

I 

1 

1 

i i 

[,STAGE2={SELECTIVE|FORCE}] 

* 

1 

1 

1 

1_ 

i i 

1_L. 

[ ,SDFFIX=XX] 

♦ 

1 


| * See the first page of this chapter. 


EIP - EXEC INTERFACE PROGRAM 


The DFHSG PROGRAM=EIP macro generates an EXEC interface program, which 
supports the functions that can be accessed via the application 
programmer’s command interface. Installations whose application 
programs use the command interface to CICS/VS will also need to specify 
the command (EXEC) language translator program. See DFHSG PROGRAM=EXP, 
below. 

/ 

| DFHSG PROGRAMMEIP must be generated when the intercommunication 
| facilities or the enhanced master /terminal are being used. 
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A list of the modules generated by DFHSG PROGRAM=BIP can be found in 
Appendix C. 


I 1 iDFHSG | PROGRAM=EIP 

|( | | [,STAGB2={SELECTIVE|FORCE} ] 

i_i_i_ 


| * See the first page of this chapter. 



EXP - COMMAND (EXEC) LANGPAGE TRANSLATOR P ROGRAM 


The system generation macro instruction necessary to generate a 
translator for the command interface to application programs written in 
PL/I, COBOL, assembler, or RPG II (CICS/DOS/VS only) is DFHSG 
PROGRAM=EXP. Installations whose application programs use the command 
interface to CICS/VS will also need to specify DFHSG PROGRAMMEIP• For 
further details, refer to the appropriate CICS/VS System Programmer*s 
Guide and to the installation manuals for the appropriate compilers. 

Note that DFHSG PROGRAH=HLL need not be generated if the macro 
interface to CICS/VS is not being used. 

The modules generated by the DFHSG PROGRAM=EXP macro instruction are: 

For LANG-COBOL 

• DFHECP — translator 
For LANG=PL/I 

• DFHEPP — translator 
For LANG-ASH 

• DFHEAP — translator 

For LANG=RPG (CICS/DOS/VS only) 

• DFHERP — translator 

In CICS/OS/VS, only the following modules are generated: 

• Assembler application interface stubs (DFHEAI, DFHEAIO) 

• COBOL application interface stub (DFHECI) 

• PL/T application interface stub (DFHEPI) 

Note : For CICS/OS/VS only. DFHEAI and DFHEAIO are generated from this 
program group even when support for the assembler HLPI is not requested. 
This is because EDF (generated from BIP) requires these assembler stubs 
at link-edit time. Users should ensure that the link—edits for DFHEAI 
and DFHEAIO are complete before link—editing the following modules: 

• DFHEDFD (in EDF) 

• DFHMIR (in ISC) 

• DFHECIP, DFHECSP, DFHECID, DFHEHTP, DFHESTP, DFHEOTP, DFHEHTD 
(command interpreter and enhanced master terminal). 
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IDFHSG 

| PROGRAM=BXP 

♦ | 



| ,LANG= ([COBOL ][ ,PLI ][ ,ASH ][ ,RPG]) 



1 

| [ ,STAGE2= {SELECTIVE | FORCE} ] 

* | 


1 

I 

| [ ,StJFFIX=XX] 

* | 


1 

1 

1 

1 

1 CICS/DOS/VS Only 



1 

1 

1 

| 

| [ , {DLI|DL1} = {NO|YES} ] 



1 

1 

a 

| 

1 CICS/OS/VS only 



1 

1 

1 

| [ , {PL1|PLI}=SHARB] 



1 

1 f.PLILIB=fSYSl.PLIBASEIdataset-namel1 



* See the first page of this chapter. 


LANG= ([ COBOL ][ ,PLI ][ ,ASH ][ ,RPG ]) 

specifies the language (s) for which a translator is required. 
If LANG=PLI is specified, the PL/I DOS/VS Release 5 or PL/I 
| OS/VS Release 3 compiler and libraries must be installed. 

Notes : 

1. PLI may also be written as PL1, PL/1, or PL/I. 

2. RPG II can only be used with CICS/DOS/VS. 

3. Any combination of COBOL, PL/I, ASH, RPG may be written, 
with the languages separated by commas and with the list 
enclosed within parentheses. 


CICS/DOS/VS Only 


{DLI | DL1} = {NO | IBS} 

indicates whether the COBOL or PL/I translators are to handle 
BXEC DLI requests as well as BXEC CICS statements. The default 
value is that specified for the DLI operand in the DFHSG 
TYPE=INITIAL macro. 

NO 

indicates that BXBC DLI requests will not be handled. 

IBS 

indicates that BXBC DLI requests will be handled by the 
COBOL and PL/I translators. 


CICS/OS/VS Only 


{PLI | PLI} =SHARE 

indicates that support for the PL/I shared library facility is 
to be generated. 
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PLILIB= fSYSI.PLlBASE ldataset-name} 

specifies the name of the data set that contains the PL/I base 
library. The default data set name is SYS1.PLIBASE. This 
operand is only applicable when PLI=SHARB is specified. 


PCP - FILE CONTROL PROGRAM 


The system generation macro instruction necessary to generate the file 
control programs is DFHSG PROGRAH-FCP. The following modules are 
generated when this macro is specified: 

• DFHFCP — which contains VSAH code and common subroutines, and will 
be accessed from the CSA. Rote that, for HVS, DFBFCP will contain 
support for VSAH fast path (ICIP files) if SRBSVC=number is 
specified in DFHSG TTPE=IHITIAL. For ClCS/DOS/VS, DFHFCP also 
contains DAH and ISAH code. 

• DFHFCD (CICS/OS/VS only) — which contains the ISAH and BDAH code. 
DFHFCD will link back to the primary module (DFHFCP) to use the 
common subroutines. 

Note : Stage 2 jobs will always be produced for DFHFCP and DFHFCD. 


IDFHSG | PROGRAH=FCP * 

| | ,FILSERV= (service[,service],...) 

| | r.AOTOJRH=fWOI YES) 1 

| | [,DUHMY=YES] * 

| | [,SUFFIX=xx] * 


* See the first page of this chapter. 


FILSERV=(service[,service],...) 

specifies which of the file services are to be generated into 
the file control programs. The applicable keyword parameters 
are as follows: 


INDA 

Input DAH 

DAUPD 

DAH Update 

DAADD 

DAH Add 

DBROWSE 

DAH sequential record retrieval 

REXAD 

Hexadecimal relative track addressing 

DECAD 

Zoned decimal relative track addressing (DAH) 

ACTAD 

Actual track addressing (DAM) 

DABLKNG 

Direct access deblocking 

INIS 

Input ISAH 

ISUPD 

ISAH Update 

ISADD 

ISAH Add 

IBROWSB 

ISAH sequential record retrieval 

IVBR 

ISAH variable—length records (DOS/VS only) 

INVS 

Input VSAH 

VSUPD 

VSAH Update 

VSADD 

VSAH Add 

VBROWSE 

VSAH sequential record retrieval 

VDELETE 

VSAH Delete 

INDIRACC 

Indirect accessing 
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EXCTL 

VLR 

LOCATE 

INSBG 

OUTSEG 


Exclusive control 
Variable—length records 
Dynamic OPBN/CLOSE/LOCATE 
Input segmenting 
Output segmenting 


Any number of these keyword parameters can be included in the 
FILSERV operand. 


Notes ; 

1. Use of the DAM file browse option under CICS/OS/VS using 
actual addressing (FILSERV-DBROWSE and ACTAD) requires that 
the user copy the CVT macro instruction and place it in 
SYS1.MACLIB. For guidance on copying the CVT macro 
instruction r see OS/VS1 Data Management for Syste m 
Programmers or 0S/VS2 System Program Library; Data 
Management . 

2. LOCATE must be specified when DFHOCP is generated and for 
DL/I under CICS/OS/VS. 

3. LOCATE must be specified if the master terminal facility is 
used to access data bases. 

4. If the Browse function is used with unblocked instead of 
blocked ISAM files, considerable performance degradation is 
likely to occur. 

5. LOCATE must be specified if AUTOJRN=YES is specified or if 
data base backout is to be supported for specific files 
defined in the file control table (DFHFCT TYPE=DATASBT, 
LOG=YBS) . 

6. INVS, VSUPD, VSADD, VBROWSE and VDELETE are not valid if 
VSAM=NO is specified in DFHSG TYPE^INITIAL. 


AUTOJRN={NO|YES} 

specifies whether automatic journaling of file accesses is to 
be supported. The default is AUTOJRN=NO. To obtain automatic 
journaling, AUTOJRN=YES must be specified in the journal 
control program as well as in the file control program. 
AUTOJRN=YES must be specified if the CICS/VS emergency restart 
or dynamic transaction backout functions are to be used. 

NO 

indicates that automatic journaling is not supported. 

YES 

indicates that automatic journaling is required. 


GAP — GRAPHIC ATTENTION PROGR AM (CICS/OS/VS ONLY) 


The graphic attention program is provided by the DFHSG PROGRAM=GAP 
macro, which must be issued only if support for local 2260 is to be 
generated. This macro applies to CICS/OS/VS only, and is not required 
under TCAM. 
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| | IDFHSG | PROGRAM=GAP 

| | | | [ ,STAGE2={SELECTIVE|FORCE} ] 

i_i_i_ 


| * See the first page of this chapter. 


* I 

* I 


HLL — HIGH-LEVEL LANGUAGE SUPPORT GROUP 


The high-level language support group , which is provided by DFHSG 
PROGRAM=HLL, allows the COBOL or PL/I application programmer to use the 
macro interface to CICS/VS. If application programs use only the 
command interface to CICS/VS, the high-level language support group is 
not required. For details of the command interface to CICS/VS, see 
DFHSG PROGRAH=EIP and DFHSG PROGRAH^EXP earlier in this chapter. 

The support programs generated in response to the DFHSG PROGRAH-HLL 
macro instruction are as follows: 

• CICS/VS preprocessor program (DFHPRPR) — for either or both 

| languages 

• Shared library transfer vector (PLISHRE), to interface between PL/I 
optimizer code and its shared library modules (OS/VS only) 

I Note ; VSE users can ignore any DFHPRPR assembly errors that occur if 
the tape macros DTFHT and MTHOD have been deleted from the source 
statement library- 



DFHSG | PROGRAM=HLL 

| [,LANG= ([COBOL )[ ,PLI]) ] 

| [ ,STAGE2= {SELECTIVE|FORCE} ] 
| [,SOFFIX=XX] 

I 

| CICS/OS/VS Only 


* 

♦ 


[ , {PLI | PL1} =SHARE ] 

[ .PLILIB- fSYS1.PLIBASE Idataset—namel ] 


| * See the first page of this chapter. 


| LANG= ([COBOL ][,PLI ]) 

identifies the languages for which support is to be generated. 
The default is LANG= (COBOL,PLI) . 

COBOL 

indicates ANS COBOL support. 

PLI 

indicates PL/I support. Note that this option can also be 
written as PL/T, PLI, or PL/1. 
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CICS/OS/VS Paly 


{PLI | PL1} =SHARE 

indicates that support for the PL/I shared library facility is 
to be generated. 


PLILIB= fSYSI.PLIBASE I dataset-name} 

specifies the name of the data set that contains the PL/1 base 
library. The default data set name is SYS 1.PLIBASE. This 
operand is only applicable with the SHAPE option of the PLI 
operand. 


ICP — INTERVAL CONTROL PROGRAB 


The system generation macro instruction necessary to generate the 
interval control program is DFHSG PROGRAM=ICP. 

If interval control requests are used to store data for a future 
task, the temporary storage program (DFHSG PROGRAH=TSP) must also be 
generated. 


r~ 

I I 
I I 
I I 


IDFHSG | PROGRAM=ICP 

| | [,STAGE2={SELECTIVE|FORCE}] 

| | [,SUFFIX=XX] 

.1-1- 


* 

♦ 


* See the first page of this chapter. 


| ISC — INTERCOBflUUICATION GROUP 

| The DFHSG PROGRAM=ISC macro instruction must be coded to provide support 
| for the CICS/VS intercommunication facilities, where communication takes 
| place between CICS/VS systems or between CICS/VS regions within a 
j system. 

| Refer to Chapter 3.5 for information on the range of CICS/VS 
I intercommunication facilities and how to write CICS/VS table entries for 
| these facilities. 

| In addition, DFHSG PROGRAM=TCP must be generated with ACCMETH=VTAil 
| and VTAMDEV=LUTYPE6 when a connection, via ACF/VTAM, is required either 
| in the same domain or cross-domain. DFHSG PROGRAM=TCP with ACCHETH=IRC 
| must be specified when a region—remote connection (through the 
| multiregion operation (MRO) facility) is required for CICS/VS regions 
| within the same processing unit. 

| The DFHSG PROGRAM=ISC macro is also required if DL/I data base 
| sharing is to take place under CICS/OS/VS. A DFHTCT TYPE=IRCBCH macro 
| must also be generated, together with the APPLID operand from the DFHTCT 
| TYPE=INITIAL macro. In addition, DFHSG PROGRAM=TCP must contain 
| ACCMETH=IRC• 
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The following programs are generated by the DFHSG PHOGRAM=ISC macro 
instruction: 

• DFHISP — intercommunication program 

• DFHHIR — intercommunication mirror module 

• DFHCRS — remote scheduler module 

• DFHCRR — Inter Region Communication (IRC) session recovery module 

• DFHELR — EXEC local/remote program 

• DFHXTP — transformer program for transaction routing 

• DFHRTR — transaction routing program 

• DFHCRP — relay program for transaction routing 

• DFHCRQ — ATI purge program 

• DFHXFP — transformer program for function shipping, which converts 
the CICS/VS parameter list into the required architected parameter 
list. 

• DFHCRSP — IRC start-up program 

• DFHCRNP — IRC connection manager 

• DFHIRP — interregion program 

• MXP — local queuing shipper program 

• SCTE — subsystem control table extension 

The following modules are for use with the DL/I shared data base 
facility under CICS/OS/VS: 

• DFHXFQ — batch transformer program 

• DFHDRP — ••bootstrap 11 program 

• DFHDRPA through DFHDRPF — batch region controller modules 

When the SUFFIX=xx operand is specified, only DFHISP, DFHELR, DFHXTP, 
and DFHXFP receive this suffix. 


| IDFHSG | PROGRAM^ISC 

| | | [,SUFFIX=xx] 


| * See the first page of this chapter. 
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JCP — JOURNAL CONTROL PROGRAM 


The journal control program is generated by DFHSG PROGRAM=JCP. The 
following journal control modules are generated in response to this 
macro instruction: 

• Journal control program (DFHJCP) 

• Journal control close program (DFHJCC) 

• Journal control open program (DFHJCO) 

• Journal control end of volume program (DFHJCEOV) 

• Journal control open/close program (DFHJCOCP) 

• Journal control journal format program (DFHJCJFP) 

• Journal control I/O error program (DFHJCIOE) 

• Journal control boot strap program (DFHJCBSP) 

• Journal control kickoff journaling program (DFHJCKOJ) 

• Journal control shut down journaling program (DFHJCSDJ) 

• Journal control input program (DFHJCI) 

Notes : 

| 1. VSE users can ignore any DFHJCOCP assembly errors that occur if the 

tape macros DTFMT and MTMOD have been deleted from the source 
statement library. 

2. Stage 2 will always be produced for DFHJCP. 

3. Only DFHJCP receives the suffix specified in the SUFFIX=xx operand. 


i-1-1-*-1 


1 

1 

(DFHSG 

1 

PROGRAM=JCP 

♦ 



1 

1 

1 

r. AOTOJRN= fNO(YBS1 1 




1 

1 

1 

[,DTB={NO|AUX|MAIN}] 



1 

1 

1 

1 

[,DUMMY=YES] 

* 



1 

1 

1 

[ , NOTE={NO|YES} ] 



1 

1 

1 

1 

[,STAGE2={SELECTIVE|FORCE}] 

* 


1 

1 

1 

1 

[,SDFFIX=XX] 

* 



i-1-1___i 


| * See the first page of this chapter. 


AUTOJRN={NO|YES} 

specifies whether automatic journaling is to be supported. 
A(JTOJRN=YES must be specified if: 


I 


• Automatic journaling of file accesses is requested for 
particular files or terminals. 

• The emergency restart function is required. 

• The dynamic transaction backout function is required. 

• DL/I is to be used with CICS/OS/VS. 
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I 

I 


DL/I logging for CICS/DOS/VS is to be performed on the 
CICS/DOS/VS system log and not on the Dl/I DOS /IS log. 


NO 

indicates that automatic journaling will not be supported. 

YES 

indicates that automatic journaling will be supported. 


DTB= {NO | AtJX | MAIN} 

indicates whether automatic logging will be performed to 
support the dynamic transaction backout function, which keeps 
copies of specific system log information in a dynamic in—core 
buffer. The default is DTB=NO. 

NO 

indicates that the dynamic transaction backout program is 
not required, and that the code to build the dynamic log 
will not be generated. 

AUX 

indicates that log records will spill into CICS/VS 
auxiliary temporary storage on direct access storage 
devices when the dynamic buffer is full. If this option is 
specified, the temporary storage program must be generated 
with AUX=YES or AtJX=REC. 


MAIN 

indicates that CICS/VS main temporary storage will be used 
when log records spill from the dynamic buffer. The 
temporary storage program must be generated if this option 
is selected. 


NOTE= {NO|YES} 

specifies whether "Note" requests to obtain positioning 
information for journal data sets are to be supported. The 
default is NOTE^NO. NOTE=YES is required to use the DFHJC 
TYPE=NOTE macro instruction. 

NO 

indicates that "Note 11 requests will not be supported. 

YES 

| indicates that "Note” requests will be supported. 


KCP - TASK CONTROL PROGRAM 

The following programs are generated in response to the DFHSG 
PROGRAM=KCP macro for the task control program: 

• Task control program (DFHKCP) 

| • Allocation program pFHALP)• The allocation program is not 

| suffixed. 

| • Sync point program pFHSPP) . The sync point program is not 

| suffixed. 

• SRB services program (DFHKCSP) 
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Mote : In CICS/0S/7S, Stage 2 jobs will always be produced for DFHKCP. 


i-1-1-• 


1 1 

IDFHSG 

| PROGRAM^KCP 

♦ 

1 

1 1 

1 

| [,STAGE2 = {SELECTIVE|FORCE} ] 

* 

1 

1 1 

1 

| [,SUFFIX=xx] 

* 

1 


I_I_L 


| * See the first page of this chapter. 


KPP— KEYPOIHT PROGRAM 


The keypoint program (DFHSG PROGRAM=KPP) is used for collecting and 
recording data from system tables and control blocks, and for writing 
that information to the restart data set and to the system log. This 
data is used by the system initialization program (DFHSIP) in warm 
starts of CICS/VS, and by the recovery utility program (DFHROP) and 
transaction backout program (DFHTBP) in emergency restarts of CICS/VS. 

Mote : Stage 2 jobs will always be produced for DFHKPP. 


I 

I 


| * See the first page of this chapter. 


i-1-1-1 

|DFHSG | PROGRAM=KPP * \ 

| | [,AKP={NO|YES}] I 

| | [,DUMMY=YES) * I 

j | [,RSDBLKS=number] I 

| | [,STAGE2= {SELECTIVE|FORCE} ] * | 

| | [,SUFFIX=XX] * | 

II I 

I I CICS/DOS/VS Only I 

I I I 


| | | [,DEVICB={2314|3330|3340|3350|FBA} ] 

•_i_i_ 


AKP={MO|YES} 

specifies whether activity keypointing is to be supported. The 
default is AKP=NO. 

NO 

specifies that activity keypointing support will not be 
generated. 

IBS 

specifies that this support will be generated. Specifying 
this option causes the following programs to be generated: 

— Activity keypoint program (DFHAKP) 

— Recovery utility program (DFHRDP) 

— Transient data recovery program (DFHTDRP) 

— Format log tape program (DFHFTAP) 

— Log tape end of file program (DFHTEOF) 

— Temporary storage recovery program (DFHTSRP) 


50 


CICS/VS System Programmer's Reference Manual 







Notes 


1. AKP=YES must be specified if emergency restart is required. 

| 2. VSE users can ignore any assembly errors that may occur in 

the DFHFTAP and DFHTEOF modules if the tape macros DTFMT 
and MTHOD have been deleted from the source statement 
| library. DFHFTAP and DFHTEOF are not required on VSE disk 

only systems• 


RSDBLKS=number 

specifies the block size of the restart data set. For 
CICS/OS/VS the default size is 512 bytes. For CICS/DOS/VS the 
default size is the track capacity of the device used, as shown 
below: 


CICS/DOS/VS Only 


Device 

BaximuD BSDB: 

2314 

7294 

3330 

13030 

3340 

8368 

3350 

19069 

FBA 

2041 


| DEVICE^ {2314 13330 | 3340 | 3350 | FBA} 

specifies the device type on which the restart data set 
resides. The default is provided in the DEVICE operand of 
DFHSG TYPE=INITIAL. DEVICE=TAPE is not valid for DFHKPP, and a 
device type of FBA will be used if TAPE would be the default. 


MTP - MASTER TERMINAL PROGRAB 


The master terminal program (DFHSG PROGR AM=MTP) , which is used by the 
master terminal (CSNT), supervisory terminal (CSST), and operator 
terminal (CSOT) transactions, is generated by the following macro 
| instruction. The enhanced master terminal support (transactions CENT, 

| CEST, and CEOT) is generated by DFHSG PROGRAN=EIP. 

i-1-1-1 

| | | DFHSG | PROGRAN=HTP * | 

|| | | [, STAGE2= {SELECTIVE | FORCE} ] * | 

i-1_i.-.- —__ _ - —--.--.-J 


| * See the first page of this chapter. 
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DFHSG PROGRAN=BTP 


51 




OCP — DYNAMIC OPEN/CLOSE PROGRAM 


DFHSG PROGRAM=OCP generates the dynamic open/close program. This macro 
| must be specified if the dynamic open/close program is to be used 

through the master terminal facility, or in response to a DFHOC request 
in an application program, or if OPBN=DEFERBED is specified in the 
DFHFCT TYPE=DATASET macro. If this program is to be used, LOCATE must 
be specified in the FILSEBV parameter of the DFHSG PROGBAM=FCP macro 
instruction. 

Mote ; In CICS/OS/VS, Stage 2 jobs will always be produced for DFHOCP. 

i - 1 - 1 --- 1 

| | IDFHSG | PfiOGBAH=OCP * I 

|| | | [,STAGE2-(SELECTIVE|FORCE}] * | 

i_i_i---• 

| * See the first page of this chapter. 


PCP - PROGRAM CONTROL PROGRAM 


DFHSG PROGRAM=PCP generates the program control program. Support for 
assembler—language and RPG II (CICS/DOS/VS only) application programs is 
automatically provided when this operand is specified. COBOL and PLI 
support is provided through the LANG operand. 

Note: Stage 2 jous will always be produced for DFHSG PROGRAM=PCP. 


1 1 

|DFHS6 

i 

PR0GRAH=PCP 

-j 

* | 

i 

i 

[ , COBOL= ([ V3 ][ , V2 ][ , V4 ][ , SUBSET ]) ] 


1 

i 

i 

[,HLLTR=(N0|YES}] 


1 1 

i 

i 

[ ,LANG= ([COBOL][,PLI]) ] 


1 1 

L _ 

i 

• _ 

i 

[,SUFFIX=XX] 

♦ | 

_- - * 


| * See the first page of this chapter. 


COBOL= ([ V3 ][ , V2 ][ , V4 ][ , SUBSET ]) 

indicates whicn ANS COBOL compilers are to be used to compile 
user—written application programs. 

13 

indicates that the ANS COBOL Version 3 Compiler (5736-CB2 
| for VSB, 5734—CB1 for OS/VS) or the VSB Compiler (5746-CB1) 

is to be used. 

V2 

indicates that the ANS COBOL Version 2 Compiler (360N-CB— 

| 482 for VSB, 360S-CB-545 for OS/VS) is to be used. 


V4 

indicates that the ANS COBOL Version 4 Compiler (5734-CB2) 
or OS/VS COBOL (5740—CB1) is to be used. 
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I 


SUBSET 

indicates that the VSE Subset Compiler (5736-CB1) is to be 
used. 

If this operand is used, LANG=COBOL must also be specified. 


HLLTR= {NO | YES} 

| specifies whether support for trace requests is to be generated 

I for high-level language application programs written in the 

| macro-level interface. The default is HLLTR=NO. If this 

operand is used, the LANG operand must also be specified. 

NO 

indicates that high-level language trace is not required. 

YES 

indicates that high-level language trace is required. 


| LANG= ([COBOL ][,PLI]) 

specifies that the optional language support is to be 
generated. 

COBOL 

indicates ANS COBOL support. 

PLI 

indicates PLI support. Note that this option can also be 
| written as PL/I, PLI, or PL/1. 


PREGEN - STARTER SYSTEM GENERATION 


DFHSG PROGRAM=PREGEN is for IBM use and is not intended for general use. 
It may be required by the user when service is being applied to starter 
system modules. (Refer to the appropriate CICS/VS System Programmer*s 
Guide (OS/VS or DOS/VS) and the DFHSPSG copybook) . 


-1 

♦ I 

_i 


IDFHSG 


PROGRAM=PREG£N 


♦ See the first page of this chapter. 


SCP — STORAGE CONTROL PROGRAM 

The storage control program is provided by the DFHSG PROGRAM=SCP macro. 
The programs that are generated by this macro are as follows: 

• Storage control program (DFHSCP) 

• Storage control recovery program (DFHSCR) 


Chapter 2.2. DFHSG PROGRAM=SCP 


53 




r-1-1-~i 

| | | DPHSG | PROGRAM=SCP * | 

| | | [ ,RECOVER={NO|YES} ] | 

|| | | [ ,STAGE2= {SELECTIVE|FORCE}] * | 

|| | | [,SUFFIX=XX] * | 

«_»_L_ ..... — . .-.— - — -.- - -J 


| * See the first page of this chapter. 


RECOVER= {NO |TES} 

specifies whether storage recovery (rebuilding chains) is to be 
attempted. The default is RECOVER=NO. 

NO 

indicates that storage recovery will not be attempted, and 
will result in the termination of CICS/VS if a storage 
violation is detected by the CICS/VS storage control 
program. 


indicates that storage recovery will be attempted. A 
storage violation will result in control being passed to 
either the CICS/VS storage control recovery (SCR) routine 
or to a user—written recovery program. (See "User Exits for 
CICS/VS Management Programs” in Chapter 6.2 of this 
manual.) 


YES 


I 

I 


SRP — SYSTEM RECOVERY PROGRAM 


The system recovery program (DFHSG PROGRAM=SRP) is a generalized 
abnormal termination handler, which is given control by the operating 
| system via the STXIT PC or STXIT AB (VSE) macros, and the SPIE, STAE or 
ESTAE (OS/VS) macro instructions. 

| To use the multi region operation (MRO) facility on CICS/DOS/VS, a 
| non—dummy SRP must be generated. 

Notes ; 

1. The dummy SRP module intercepts program checks, allowing CICS/VS to 
perform certain clean—up operations. It will issue SPIE (OS/VS) or 

| STXIT PC (VSE) macros, but will not handle abnormal terminations. 

However, unlike the full version of the SRP, the dummy SRP does not 
provide recovery action for program checks. 

2. Stage 2 jobs will always be produced for this program in 
CICS/OS/VS. 


i-1-1-» 


1 1 

|DFHSG 

| PROGRAH=SRP 

♦ 

1 

1 1 

1 

| [ ,DUMMT=YES] 

* 

1 

1 1 

J 

! [ # ST»GE2={SELECTIVE!FORCE) j 

♦ 

1 

i i 

i 

| [,SUFFIX=xx] 

♦ 

1 


i-1_i_i 


| * See the first page of this chapter. 
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TBP -TRANSACTION BACKOUT PROGRAM 


The transaction backout program (DFHTBP), which is generated by DFHSG 
PROGRAM=TBP , is responsible for backing out changes made to CICS/VS 
protected resources by transactions that were in—flight at the time that 
the system was interrupted. This program must be generated if the 
keypoint program is generated with AKP=YES. 

The transaction backout program is a required component of emergency 
restart and is also responsible for collecting messages to allow message 
recovery. Further information on DFHTBP can be found in Chapter 4.8. 

Note: Stage 2 jobs will always be produced for this program in 
CICS/OS/VS. 


| | IDFHSG | PROGRAM=TBP * 

II I I [ ,{DLI|DL1} = {YES|N0} ] 

|| | | [ # STAGE2= {SELECTIVE I FORCE} ] * 

i- 

| * See the first page of this chapter. 


| {DLI | DL1} = {YES | NO} 

indicates whether DL/I support is required for this program, 
and may be used to override the option specified in DFHSG 
I TYPE=INITIAL. DLI or DL1=YES cannot be specified in 

| CICS/OS/VS. If DLI or DL1=N0 is specified, a transaction 

| backout program without DL/I support will be generated, 

| regardless of the DL/I option specified in DFHSG TYPE=INITIAL. 


TCP — TERMINAL CONTROL PROGRAM 

The system generation macro instruction necessary to generate the 
terminal control program is DFHSG PROGRAM=TCP. 

The programs generated are as follows. 

For all access methods: 

• DFHZCNC — console write—to-operator (OS/VS only) 

• DFHP3270 — 3270 print function support 
For ACCMETH=VTAM: 

• DFHGMM — good morning message program 

• 3270 print function support modules: 

- DFHRKB 
DFHCPY 
DFHPRK 

- DFHEXI 

• DFHZHPRX — RPL executor in SRB mode (MVS only) 
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| • DFHZRSP — resend program 

I • DFHZRLG — response logging program 
I • terminal control program modules: 

| - DFHZCA 

| - DFHZCB 

| - DFHZCP 

| - DFHZCX 

| - DFHZCY 

| - DFHZCZ 

| • DFHZNAC — node abnormal condition program 

| • DFHZNEP — node error program 

| For ACCMETH values other than VTAM: 

| • DFHTCP — terminal control program 

Notes : 

1. If SBBSVOnumber is specified in DFHSG TYPE=INITIAL, VTAM 
authorized path is used in DFHZCP to give improved performance 

| characteristics. This applies only to MVS. 

2. DFHTCP, DFHZCP, DFHZCB, DFHZCX, and DFHZCZ will receive a suffix 
when the SUFFIX=xx operand is specified. 
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I 


1- 

IDFHSG 

r~ 

i 

PEOGRAM=TCP 

♦ 

“1 


i 

i 

, ACCMETH= (method[ ,method ],...) 




i 

i 

[, ANSWRBK= (identification^,identification],...)] 




! 

i 

[,AUTOTRN={NO|YES}] 




1 

i 

[ ,BSCODE= ([EBCDIC][ ,ASCII ]) ] 




1 

i 

[ ,BTAMDEV= (device[ ,device ],...) ] 




1 

i 

r ,CHNASSY=(NO 1IBS) 1 




1 

i 

[.CMPT60L=f(240.480.960)| (n1,n2,n3)}] 




1 

i 

[ ,C0MPAT={N0| ([ FORMAT ][ ,FULLBUFF ][ ,F2260 ])} J 




1 

i 

[ ,C0NVTAB= ([ ABB][ ,ABC][ ,2741BU][ ,2741EM] 




1 

i 

[ r 2741CU J r 2741CH]) ] 




1 

i 

[,DEVICE=(device[,device],...)) 




1 

i 

[ / EODI={EO|xx} ] 




1 

i 

[,FEATDRE=(feature[,feature],...)] 




1 

i 

[ ,FMT2260=(r 6X401[ ,12X40 ][ ,12X80 I ,15X64]) ] 




I 

i 

T ,FMT3270=ff 12X40 ir.24X80]) ] 




1 

i 

[,L0CKF=YES] 




1 

i 

[,LOGREC={NO|YES}] 




1 

i 

[ ,PIPELN={NO|YBS} ] 




1 

i 

[,PONSOL={YES|NO}] 




1 

i 

[,SMI={g|character}] 




1 

i 

[,STAGE2={SELECTIVE|FORCE}] 

♦ 



1 

i 

[,S0FFIX=xx] 

♦ 



1 

i 

[ ,TAB= {NO|YES} ] 




1 

i 

r,TBLFIX=(NO 1 YES)1 




1 

i 

[,TNX0FF=XX] 




1 

i 

[,TWX0N=XX] 




1 

i 

[ ,0CTRAN= {NO | ([ EBCDIC X ,ASCII])} ] 




1 

i 

[ ,VTAMDEV= (device[ ,device],...) ] 




1 

1 

i 

t 

[,WRAPLST= {NO|YES} ] 




1 

1 

1 

1 

i 

1 

CICS/OS/VS Only 




! 

i 

1 

i 

[,INITRL=YES] 




i 

i 

[ ,TCM3270=YES] 



A 

i_ 



_» 


| * See the first page of this chapter. 


ACCMETH= (method[ method],...) 

identifies the access method (s) to be used in the terminal 
environment. One or more of the following keyword parameters 
must be specified: 


Method 


Required 


TCAM — Telecommunications Access Method (OS/VS only) 

BTAM — Basic Telecommunication Access Method BTAMDEV 

BSAM — Basic Seguential Access Method DEVICE 

SAM — Sequential Access Method DEVICE 

BGAM — Basic Graphics Access Method (OS/VS only) 

VTAM — Virtual Telecommunications Access Method VTAMDEV 
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IRC — Interregion communication access method for 
DL/I shared data base support in CICS/OS/VS, 
and for region-remote connections when MRO is 
being used. See note 4. 


SAM and BSAM are functionally synonymous in CICS/VS and can be 
used interchangeably. Only unblocked data sets can be used 
with SAM or BSAM. SAM is required to support the processor 
console as a terminal (CICS/DOS/VS only). BGAM provides the 
2260 support for CICS/OS/VS, while BTAM provides the 2260 
support for CICS/DOS/VS. 

Notes: 


1. ACCMETH=VTAM may not be specified if VTAM=N0 was specified 
in DFHSG TYPE=INITIAL. 

2. ACCMETH=VTAM and VTAMDEV=LUTYPE6 must be specified for a 
connection, via ACF/VTAM, that is either in the same domain 
or cross—domain. 

3. ACCMETH=IRC generates control code in the group of DFBZCP 
modules for the DL/I shared data base interregion control 
module. ACCMETH=IRC must also be specified for a region- 
remote connection when the multiregion operation (MRO) 
facility is being used. 


ANSWRBK= (identification[ ,identification],...) 

specifies the type of terminal identification and must be used 
if FEATURE=AUTOANSW is specified. The parameters of this 
operand are not mutually exclusive. This operand is applicable 
only when ACCMETH=BTAM is specified. 

AUTOMATIC 

specifies that automatic terminal identification is to be 
sent by the terminal. This option is only valid for 
BTAMDEV-TWX• 


EXIDVER 

specifies that BTAM expanded identification verification is 
to be used to identify those terminals that transmit unique 
identification sequences. ANSWRBK=EXIDVER may be specified 
for all BTAM BSC dial devices (except for the 2780) that 
require the expanded ID verification feature. 

TERMINAL 

specifies that the operator will supply the identification 
for switched lines. 

7770TERM 

specifies that the operator will supply the terminal 
identification. 
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7770NULL 

specifies that no terminal identification is to be sent by 
either the terminal or by the operator; instead, the 
terminal control program will connect the line to the next 
available terminal in the terminal pool. The default is 
ANSWRBK=7770TERM, providing BTAMDEV=7770 has also been 
specified. 

Note: The ANSWRBK operand must include all keyword parameters 
for which the corresponding parameter is to be included in 
DPHTCT TYPE-LINE. 


ADTOTRN={NO|YES} 

specifies whether the optional automatic transaction initiation 
feature is to be included in CICS/VS. The default is 
| AUTOTRN=NO. 

NO 

indicates that automatic transaction initiation will not be 
supported. 


YES 

indicates that automatic transaction initiation will be 
supported. 


| BSCODE= ([EBCDIC ][, ASCII]) 

specifies which types of binary synchronous communication code 
are to be supported when ACCMETH=BTAM is specified. The 
default is BSCODE= (EBCDIC,ASCII) • 

EBCDIC 

indicates Extended Binary Coded Decimal Interchange Code. 
ASCII 

indicates American Standard Code for Information 
Interchange• 


BTAMDEV= (device[ ,device], ...) 

identifies the BTAM device types and must be present if 
ACCMETH=BTAM is specified. The applicable keyword parameters 
are: 


• 1050 

• 1050D 

• 1053 

• 2260 

• L2260 

• 2265 

• 2740 

• 2740D 

• 2740-2 


1050 Data Communication System 

1050 Data Communication System (dial-up) 

1053 on a Local/Remote 2848 Control Unit 
2260 Display Station (Remote) 

2260 Display Station — Local (CICS/DOS/VS only) 

2265 Display Station 

2740 Communication Terminal Model 1 

2740 Communication Terminal Model 1 (dial-up) 

2740 Communication Terminal Model 2 (2740 must 
also be specified) 
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• 2741C 
V 274 IB 

• 2741DC 

• 2741DB 

• 2770 

• 2770D 

• 278 0 

• 2780D 

• 2980/1 

• 2980/2 

• 2980/4 

• 3275 

• 3275D 

• L3270 

• R3270 

• 3600 

• 3660 

• 3735D 

• 3740 

• 3740D 

• 3780 

• 3780D 

• 7770 

• SYS/3 

• SIS/3D 

• SYS/7 

• SYS/7D 

• S/370 

• S/370D 


2741 Communication Terminal with correspondence code 

2741 Communication Terminal with PTTC/EBCD code 

2741 Communication Terminal with correspondence 
code (dial-up) 

2741 Communication Terminal with PTTC/EBCD 
code (dial-up) 

2770 Data Communication System 

2770 Data Communication System (dial-up) 

2780 Data Transmission Terminal 

2780 Data Transmission Terminal (dial-up) 

2980 General Banking Terminal System Model 1 

2980 General Banking Terminal System Model 2 

2980 General Banking Terminal System Model 4 

3275 Display Station (remote) 

3275 Display Station (dial-up) 

Local support for 3276, 3277, 3278, 
and 3279 Display Stations and 3284, 3286, 

3287, 3288, and 3289 Printers 

Remote support for 3276, 3277, 3278, 
and 3279 Display Stations and 3284, 3286, 

3287, 3288, and 3289 Printers 

3600 Finance Communication System 

3660 Supermarket System 

3735 Programmable Buffered Terminal (dial-up) 

3740 Data Entry System 

3740 Data Entry System (dial-up) 

3780 Data Communication Terminal 

3780 Data Communication Terminal (dial-up) 

7770 Audio Response Unit Model 3 
System/3 Models 6 and 10 
System/3 Models 6 and 10 (dial-up) 

System/7 

System/7 (dial-up) 

System/370 
System/370 (dial-up) 
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• S/7BSCA System/7 with Binary Synchronous Communications 

Adapter 

• S/7BSCAD System/7 with Binary Synchronous Communications 

Adapter (dial-up) 

• TLX Teletypewriter (WTC only) 

The Autocall feature is not supported by CICS/VS. 
(This feature is for World Trade users only.) 

• TWX CPT-TWX (Model 33/35) 

• BISYNC Binary synchronous device (for CICS/OS—STANDARD 

VI compatibility) 

Note : L3270 and R3270 are synonymous with the individual names 
of the 3270 family of devices. 

Individual device type parameters are provided for the BTAMDEV 
operand so that system generation input is self-documenting. 

If the parameter length for this operand exceeds the assembler 
limit of 255 characters for the particular system being 
generated, synonymous parameters can be omitted. Specifying 
any one of the parameters from a group produces code for all 
devices in the group. These groups are: 


• SYS/3, S/370, BISYNC, S/7BSCA 

• SYS/3D, S/370D, S/7BSCAD, 3660 

• 2260, 2265 

Note : When BSC lines are part of the user*s configuration, it 
is possible for these communication lines to time-out if 
control is not returned to the terminal before a time-out can 
occur. The user can alleviate this condition by having the 
application program issue a CICS/VS task control WAIT macro 
instruction to relinquish control voluntarily. 


CHNASSY=fNO |YES} 

indicates whetner a complete SNA chain of logically grouped 
records is to be read before presenting any of the input data 
to the application program. This operand is only to be used 
when ACCMETH=VTAM is specified. The default is CHNASSY=NO. 

NO 

specifies that chain assembly support is not to be 
generated in the ZCP group of modules. 

YES 

specifies that chain assembly support is to be generated in 
the ZCP group of modules. 
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| CMPT60L= f (240.480,960 )1 (n1,n2,n3)} 

specifies the minimum size of the terminal input output area 
(TIOA) that will be passed when an input operation completes 
for any transaction running under 2260 compatibility. The 
default values are CMPT60L= (240,480,960). 

This operand must be specified if any of the transactions that 
are to be run under 2260 compatibility requires an input TIOA 
larger than the standard compatibility default. If a value is 
supplied for any of the parameters which is smaller than the 
corresponding default, the default value will be used. This 
operand corresponds in function to the INAREAL specification 
formerly made in the DPHTCT TYPE=LINE macro instruction for the 
2260/2265 configuration. 

nl 

indicates the minimum size TIOA for a 3270 simulating a 240 
character screen size 2260/2265. 

n2 

specifies the minimum size TIOA for a 480 character screen 
size simulation. 

n3 

specifies the minimum size TIOA for a 960 character screen 
size simulation. 


C0MPAT={N0| ([ FORMAT ][ ,FULLBUFF ][ ,F2260 ])} 

generates 2260-compatibility support for the 3270 Information 
Display System. Such support allows the user to run his 
currently operational 2260-based transactions from a 3270. 

| This support is not available for TCAM or VTAM terminals. The 

default is COMPAT=NO. 


NO 

indicates that 2260—compatibility support for the 3270 is 
not to be generated. 

FORMAT 

indicates that FORMAT compatibility mode is to be 
generated. FORMAT mode takes full advantage of the 3270 
formatting and data compression facilities, and is the 
preferred method of 2260-compatibility operation, 
particularly for remote 3270s. 


FULLBUF 

indicates that FULLBUF compatibility mode is to be 
generated. FULLBUF mode does not use the 3270 data 
compression facilities and must therefore be used when all 
lines of input data are required. 


F2260 

indicates that FASTER 2260 compatibility support for the 
3270 Information Display System is to be generated. This 


to execute a currently operatxonal 


FASTER 2260—based transaction using a 3270 terminal. 


Notes: 


1. If COMPAT=FORMAT and/or FULLBUFF is specified, FMT2260 and 
FMT3270 must be used to specify the screen formats. 
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2. If a 480-character 2260 is mapped onto a 480-character 
3270 , use of FORMAT mode causes the loss of the last 
character of each 2260 output line. Ose of FOLLB0F mode 
limits the data loss to the last character position of the 
last line but at the expense of transferring a full 480 
characters for each interaction involving a data entry key. 


C0HVTAB= ([ ABB ][ ,ABC][ ,274 1E0 ][ , 2741EM ][ ,274 ICO ][ ,2741CM ]) 

specifies the type of conversion to be performed on the data 
received from the 7770 Audio Response Onit or the 2741 
terminal. 

• If BTAMDBV=7770, CONVTAB=ABB and/or ABC applies. The 
default is CONVTAB= (ABB,ABC) . 

• If BTAMDEV=2741E and/or 274 IDE, CONVTAB=2741EU and/or 
2741EM applies. The default is CONVTAB=2741EO. 

• If BTAMDEV=2741C and/or 2741DC,C0NVTAB=2741CU and/or 2741CM 
applies. The default is C0NVTAB=2741C0. 

ABB 

indicates conversion from ABB transmission code. 

ABC 

indicates conversion from ABC transmission code. 

2741EU 

indicates that data received from a 2741 EBCDIC terminal 
will be translated to uppercase. 

274 IBM 

indicates that data received from a 2741 EBCDIC terminal 
will be translated to text mode. 

274 ICO 

indicates that data received from a 2741 correspondence 
terminal will be translated to uppercase. 

2741CM 

indicates that data received from a 2741 correspondence 
terminal will be translated to text mode. 

Note : The 2741 Autocall feature is not supported by CICS/VS. 


DEVICE=device[ ,device,... ] 

identifies the direct access or sequential devices that are to 
be used in the terminal environment. This operand must be used 
if ACCMETH=SAM or ACCMETH=BSAM is specified. The applicable 
parameters are: CRLP (card reader, line printer), DASD, TAPE, 
and (CICS/DOS/VS only) CONSOLE. 


EODI={EO|xx> 

specifies the end-of-data indicator for sequential input. The 
characters xx represent two hexadecimal characters in the range 
01 to FF. The default is EODI=E0, which is equivalent to the 
0—2—8 punch formerly used as an end-of—data indicator. 
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FEATURE*feature[ ,feature,... ] 

specifies the special features present in the terminal 
environment. The applicable keyword parameters are: 


• AUTOANSW Automatic answer feature. This enables a 

control unit to respond automatically to a call 
received over a switched line. When BTAM is 
used, this feature is required for the 
3275 and for all dialed devices. 

• AUTOPOLL Automatic polling feature. When BTAM is 

used, this feature is required for multipoint 
BSC terminals. 

• BUFFRECV Buffered receive feature for 2740 Model 2. 

• PSEUDOBIN Pseudo—binary transmission code for System/7 

• RDATT 2741 Read Attention feature 

• TRANSPARENCY Character transparency for the 2770,2780, 

3600 BSC, S/3, S/370, and S/7BSCA. 

• WRBRK 2741 Write Break feature (OS/VS only) 


FMT2260=([ 6X40 ][, 12X40 I , 12X80 ][ ,15X64]) 

specifies the various 2260 screen formats to be simulated for 
2260—based transactions on the 3270 Information Display System. 
The default is FMT2260=6X40. The applicable keyword parameters 
are: 

6X40 

240-character 2260 Display Station 
12X40 

480-character 2260 Display Station 
12X80 

960-character 2260 Display Station 
80-column format for the 2265 Display Station 
15X64 

15—row, 64—column format for the 2265 Display Station 


FMT3270= ([12X40 ][ ,24X80 ]) 

specifies the 3270 screen formats on which 2260 screen formats 
are to be simulated for 2260—based transactions. The default 
is FMT3270=12X40. The applicable keyword parameters are: 

12X40 

480-character 3275/3277 Display Station 
24X80 

1920-character 3275/3277 Display Station 
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LOCKF=YES 


specifies that the optional keyboard lock feature, supporting 
the 2848 models 21 and 22, is to be included in CICS/VS. The 
FEATURE=KBRDLOCK operand must be included in DFHTCT TYPE=LINE 
to have the keyboard lock feature operative for that line. 

This operand applies only to 2260 devices. For CICS/DOS/VS, if 
LOCKF-YES is specified and if F EATURE=KBRDLOCK is included in 
DFHTCT TYPE=LINE, the keyboard is locked on all reads including 
the initial read. 


LOGREC= {NO | YES} 

indicates whether deblocking input records (so that the 
application program can read each logical record) is to take 
place. The default is LOGREC=NO• This operand only applies 
when ACCMETH=VTAM is specified. 

NO 

specifies that logical record presentation support is not 
to be generated in the ZCP group of modules. 


YES 

specifies that logical record presentation support is to be 
generated in the ZCP group of modules. 


PIPELN= {NO | YES} 

indicates whether 3600 or 3650 pipeline session support is 
required. The default is NO. 

NO 

specifies that 3600 or 3650 pipeline session support is not 
required. 

YES 

specifies that 3600 or 3650 pipeline session support is 
required. PIPELN=YES is required for 3606/3608 and 3653 
pipeline sessions. SESTYPE=PIPELINE must also be indicated 
in DFHTCT TYPB=TERHINAL. 


PUNS0L= {YES | NO} 

may be used to generate support for protecting the 3270 logical 
unit from receiving unsolicited input. The default is 
PUNSOL=YES. 

In normal operation, the 3270 terminal operator is expected to 
wait until the keyboard is unlocked by a reply from the 
application program before attempting to enter further input. 
Use of the reset key to allow further input before the 
application program replies is not regarded as normal use of 
the terminal. Specifying PUNSOL=YES will protect application 
programs from receiving such unsolicited input (which may cause 
a synchronization problem between the operator and the 
application program). CICS/VS can check whether such 
unsolicited data has been received and can discard it, without 
giving any indication that it was received. PUNSOL need not be 
specified for a 3270 compatibility mode logical unit because 
the compatibility mode controller function protects CICS/VS 
from unsolicited input. 

YES 

indicates that protection is required. 
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NO 


indicates that protection will not be provided 


SMI- {g|character} 

specifies the character that is to represent the start of 
message indicator (SMI) in all messages to and from the 3270 
operating in 2260 compatibility mode. This character is 
generated as a X , 4A I and must be a valid alphameric displayable 
character. If the SMI character is contained in an output data 
stream, its display is dependent upon the language feature 
specified for the 3270. The character chosen remains the same 
for all transactions. The default is SMI=j*. 


TAB-{NO|YES} 

specifies whether any of the 2260-compatible 3270 transactions 
make use of the 2260 tab feature. The default is TAB=N0• 

NO 

indicates that the 2260 tab feature is not used. 

YES 

indicates that all colon (:) characters are honored as 2260 
tab characters when included in the 3270 output data 
stream. 


TBLFIX={NO|YES} 

specifies the generation of the 2980 translate tables. The 
default is TBLFIX=NO. 

NO 

causes skeleton translate tables to be generated, which are 
used to build the translate tables dynamically each time 
input or output is converted. This is used to conserve 
storage. 


YES 

uses a set of preassembled tables for better performance. 


TWX0FF=xx 

generates instructions to handle the transmit-off character, 
which is specified by the CHAREC= (XOFF,xx) parameter when the 
EP/3705 is generated for a TWX terminal. 

Note : The TWXOFF and TWXON operands (see below) need only be 

specified when BTAMDBV=TWX is specified. 


TWX0N=xx 

generates instructions to handle the transmit—on character, 
which is specified by the CHAREC= (X0N,xx) parameter when the 
EP/3705 is generated. 

Note : All generated EP/3705 lines used by CICS/VS must have 

the same value specified for the CHAREC parameter. 


UCTRAN= {NO | ([ EBCDIC ][,ASCII ])} 

generates instructions to translate lowercase data to uppercase 
in 3270, 3767, and 3770 SDLC input data streams. The default 
is UCTRAN=N0• 
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HO 

indicates that uppercase translation is not required. 

EBCDIC 

indicates that EBCDIC support is to be generated, when 
PBATORE=OCTRAH is specified in DFHTCT TYPE=TBRMINAL for: 

- VTAM 3270s 

- SDLC 3767s and 3770s 

- Non-VTAM 3270s when BSCODB=BBCDIC and/or CONVTAB=EBCDIC 
is specified in DPHTCT TYPE=LINB 

BSCODE and COHVTAB do not apply for 3270 or LUTYPE2 logical 
units, so OCT RAN=EBCDIC will generate translation support 
for all 3270s. 

ASCII 

indicates that support is to be generated for BTAH 3270s. 
Por BSC 3270s, translation is available by means of HCP 
translation tables in the 3704/3705. There is no support 
for ASCII-encoded data received from 3270 compatibility 
mode logical units. 

Oppercase translation for the 3270, 3767, or 3770 SDLC devices 
is only performed on input data streams received from those 
devices for which FBATURE=OCTRAN is specified in DFHTCT 
TYPE=TBRMINAL, except to satisfy DFHTC TYPB=TEXT or terminal 
control ASIS requests. Translation is not performed on data 
copied from a display to a printer. 


VTAMDEV=(device[,device],...) 

identifies the logical units and must be present if 
ACCMETH=VTAM is specified. The applicable keyword parameters 
are: 

3600 3600 Finance Communication System 

3614 3614 Consumer Transaction Facility 

3650 3650 Retail Store System 

3790 3790 Communication System 

3270 3270 Information Display System. (Does not include 

support for 3270s running as an L0TYPE2, L0TYPB3 
or SCSPRT logical units) 

BCHLO Batch logical unit support 

3770 3770 Data Communication System (batch logical unit) 

3770B 3770 Data Communication System (batch logical unit) 

INTLU Interactive Logical Unit (flip-flop mode) 

3767 3767 Communication Terminal operating as INTLU 

3767c 3767 Communication Terminal operating as an interactive 

logical unit in contention mode 

37671 3767 Communication Terminal operating as INTLU 
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377QC 


3770 Data Communication system (models 3771, 3773, 3774, 
3775 only) operating as an interactive logical unit 
in contention mode 

37701 3770 Data Communication System operating as INTLU 

LUTYPB2 SNA type 2 logical unit (3270—compatible 
logical unit) 

L0TYPB3 SNA type 3 logical unit (3270 printer logical 
unit) 

LUTYPB4 SNA type 4 logical unit 

L0TYPE6 Session Type 6 logical unit for ISC support 


SCSPRT SCS printer logical unit (for example, 3287, 3289) 


• INTLD generates support for 3767 and 3770 (models 3771, 
3773, 3774, and 3775 only) interactive logical units in 
flip-flop node, and for VTAMDEV=SCSPRT. 3767, 37671, and 
37701 may also be specified. 

• BCHLU (or 3770 or 3770B) also generates support for the 
3770 batch data interchange, L0TIPE4, and 3770 full 
function logical units. 

• VTAMDEV=3790 generates support for LOTYPE2, L0TYPE3, and 
SCSPRT logical units. 

• VTAHDBV=INTLU or VTAMDEV=3767C must be specified when TWX 
and TLX devices are to run as logical units under VTAM 
through the Network Terminal Option (NTO). 


WRAPLST={NO|YES) 

specifies whether the optional wrap list feature is to be 
included in CICS/VS. The list to be constructed is a wrap¬ 
around polling list for a nonswitched line. The polling list 
is to be constructed in the terminal control table. This 
operand is for BTAH only. The default is NRAPLST=NO. 

NO 

indicates that a wrap list will not be used for polling. 

YES 

indicates that a wrap list will be used for polling. 


S l g S / Qg /y s Onl y 


INITRL=YBS 

specifies that all reads from other than an application program 
are with the keyboard lock option. The FBAT0RE=KBRDLOCK 
operand must be included in DFHTCT TYPE=LINE to have the 
keyboard lock feature operative for that line. This operand 
applies only to 2260 devices. 


TCH3270=YBS 

is required if TCAH support includes the 3270 Information 
Display System. 
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TDP — TRANSIENT DATA CONTROL PROGRAM 


The system generation macro instruction necessary to generate the 
transient data control program is DFHSG PROGRAM=TDP. If neither the 
INTRA nor EXTRA operand is specified, a dummy transient data program 
will be generated. 

The device type for use with intrapartition transient data via DAM 
| (for VSE only) is specified in the DFHDCT TYPE=INITIAL macro. 

Note : Stage 2 jobs will always be produced for this program. 


1 

1 

1- 

|DFHSG 

T 

1 

PROGRAM=TDP 

♦ 

1 


1 

i 

1 

[ ,DESTRCV= {NO | YES} ] 



1 

1 

i 

1 

[,DUMMY=YBS] 

♦ 


1 

1 

i 

1 

[ ,EXTRA=([ ACQUISITION I ,DISPOSITION ]) ] 




1 

i 

1 

[ ,INTRA=([XES][ , {DAM IBDAM |VSAM} ][ ,TRANSINIT]) ] 



1 

1 

i 

1 

[,STAGE2={SELECTIVE|FORCE}] 

♦ 


1 

1 

i 

1 

[,SUFFIX=xx] 

♦ 



i-•---1-1 


| * See the first page of this chapter. 


DESTRCV^{NO|YES} 

indicates whether support is to be included to enable emergency 
restart or dynamic transaction bacfcout to use intrapartition 
transient data destinations that are specified as recoverable 
in the destination control table. The default is DBSTRCV=NO. 

NO 

indicates that this support will not be generated. 

YES 

indicates that the support will be included for transient 
data recovery. See the description of '‘Generating 
Recovery/Restart Support” later in this chapter, and in 
Chapter 4.8. 


| EXTRA= ([ ACQUISITION ][ ,DISPOSITION ]) 

specifies that extrapartition data sets are to be used. 

ACQUISITION 

indicates input from an extrapartition data set. 

DISPOSITION 

indicates output to an extrapartition data set. 

Note : For further information on extrapartition data sets, see 

the section on transient data in the appropriate CICS/VS 
Application Programmer's Reference Manual . 


INTRA = ([YES ][ {,DAM|BDAM|VSAM} ][ ,TRANSINIT ]) ] 

indicates that intrapartition queues are to be used. The 
default is INTRA=DAM. 

YES 

indicates that intrapartition queues are to be used, and is 
retained only for reasons of compatibility with previous 
releases of CICS/VS. For example, if YES is the only 
option specified, a default of DAM will be provided. 
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DAM|BDAM 

indicates that the intrapartition queues are to be used 
with DAM. BDAM is provided as as alternative spelling. 


VSAM 

indicates that the intrapartition queues are to be used 
with VSAM. This option cannot be used when DAM or BDAM is 
specified. 

TRANSINIT 

indicates that intrapartition queues are to be supported 
with the automatic task initiation feature. 

For further information on intrapartition data queues, 
refer to the appropriate GICS/VS Application Programmer^ 

I Reference Manual . 


TRP — TRACE CONTROL PROGRAM 


The trace control program (DFHSG PROGRAM =TRP) is used for program 
maintenance and performance tuning. Used in conjunction with the trace 
utility program, this feature provides for easy use of CICS/VS trace 
facilities. 

N ote ; Stage 2 jobs for this program will always be produced in 
CICS/DOS/VS. 


I 

I 

I 

I 


i-1-i -- - - ------ - — .. . . . . ..i 

| IDFHSG | PROGRAM=TRP * | 

I I I [ ,AUX= {NO | YES} ] | 

| | | [,DUMMY=YES] * | 

| | | [,STAGE2={SELECTIVE|FORCE}] * | 

| | | [ ,SUFFIX=xx] * | 

III I 

I I I CICS/DOS/VS Only | 

III I 

| | | f,DEVADDR= f0091nnn} 1 | 


| | | [,DEVICE={TAPE|2314|3330|3340|3350|FBA)] | 

i_i_i___» 


| * See the first page of this chapter. 


AUX= {NO | YES} 

specifies whether the optional feature of writing CICS/VS trace 
entries on a QSAM data set is to be generated. The default is 
AUX=NO• 


NO 

indicates that support for writing trace entries is not to 
be included. 

YES 

indicates that support for writing trace entries is to be 
included in addition to support for a main storage trace 
table. 
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CICS/DOS/VS Only 


DEVADDR* {0091 nnn) 

| specifies, for DEVICB=TAPB only, the VSE device address to be 

assigned to the tape drive. The address must be a three-digit 
decimal number vith leading zeros, if necessary. For example, 
if SYS008 is the device address to be used, DBVADDR=008 must be 
specified. The default is DEVADDR=009. If the DEVICE operand 
is used, the DEVADDR value is picked up from the label 
information supplied for the auxiliary trace data set. 


DEVICE* {TAPE | 23141 3330 | 334013350 | FB A} 

specifies the type of output device. A particular trace 
control program in CICS/DOS/VS will support only one type of 
output device. If different device types are to be used on 
different runs, more than one trace control program must be 
generated using the SUFFIX operand. The default is the device 
type specified or defaulted in DFHSG TYPB=INITIAL. 


TSP — TEMPORARY STORAGE CONTROL PROGRAM 

The system generation macro instruction necessary to generate the 
temporary storage control program is DFHSG PROGRAN=TSP. 

Note: The temporary storage program must be generated if: 

• the interval control program is used to store data. 

| • EDF is required. 

| • BUS paging is required. 

| • the routing transaction CRTE is required. 


I-j- 1 -■-| 

i | |DFHSG | PROGRAM=TSP * | 

I I I r ,AOX= fYES IHOIRBCl 1 | 

|| | I [,D0MHY=YES] * | 

|| | | [ ,STAGE2= {SELECTIVE|FORCE}] * I 

II I I [,S0FFIX=xx] * I 

i_i_i___• 


| * See the first page of this chapter. 


A0X={YES|N0|REC} 

specifies whether auxiliary storage is to be supported. The 
default is AUX=YBS. The AUX=NO option can be useful for 
generating a development or test system. It provides an 
operational convenience by eliminating the need to define data 
space and data sets for temporary storage. 

YES 

indicates that auxiliary storage support is to be 
generated. 
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NO 

indicates that no auxiliary storage support is to be 
generated and that temporary store write requests will 
store data in main storage regardless of the STORFAC 
parameter specified in the user*s request. AUX=NO must be 
specified if VSAM=NO is specified in DFHSG TYPE=INITIAL. 


REC 

indicates that auxiliary storage support is to be generated 
and that certain auxiliary temporary storage identifiers, 
as defined in the temporary storage table (TST) , will be 
recoverable. That is, they will be restored by the 
emergency restart and dynamic transaction backout functions 
| in the event of a transaction or system failure. 


TERMINATION — DFHSG TYPB=FINAL 


Stage 1 is terminated in response to the DFHSG TYPE=FIHAL macro 
instruction. This macro instruction must be the last statement of the 
system generation input stream preceding the assembler END statement. 
The assembler END statement does not require an operand. 


|DFHSG | TYPE^FINAL 


TYPE=FINAL 

indicates the end of CICS/VS stage 1 system generation. 
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Chapter 2.3. Generating Recovery/Restart Support 


The generation of Recovery/Restart support in CICS/VS can be divided 
into the following functions: 

• Handling telecommunications errors 

• Handling program checks in application programs 

• Handling operating system abends 

• The CICS/TS warm restart mechanism 

• The CICS/VS dynamic transaction backout facility. 

• The CICS/VS emergency restart mechanism 

The CICS/VS Svstem/Application Design Guide discusses the various 
functions of recovery/restart in detail. This section describes the 
actions necessary in the system generation process to take advantage of 
these facilities. Certain specifications also need to be made during 
preparation of the system tables. These are described in Chapter 3.3 of 
this manual. 


TBLBCOMMPHICATIOHS ERRORS 


DPHS6 PROGRAM=RSP must be specified to generate the resend program if 
support for logical units is included in the system. RBSEND=TBS must be 
specified in this macro if messages (that were not transmitted 
successfully because of a line failure) are to be resent. This operand 
must also be specified if 3614s are attached to the CICS/VS system. 


PROGRAM CHECKS IB APPLICATION PROGRAMS 


DFHSG PROGRAH=SRP must be specified to generate the system recovery 
program if CICS/VS is to intercept program checks and abend the 
transactions that caused them on a selective basis. 


OPBRATIMG SYSTEM ABENDS 


DFHSG PROGRAM=SRP must be specified to generate the system recovery 
program if CICS/VS is to intercept operating system abends and either 
attempt recovery or terminate CICS/VS in as orderly a manner as 
possible. 

| A non—dummy SRP must be generated if the multiregion operation (NRO) 
| facility is to be used on CICS/DOS/VS. 
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CICS/YS WARM RESTART 


DFHS6 PBOGRAM=KPP must be specified to generate the keypoint program if 
the CICS/VS warm restart facility is to be used. It is not necessary to 
specify AKP=YES in this macro if the emergency restart facility is not 
required. 


CICS/VS DYNAMIC TRANSACTION BACKOUT 


The following specifications must be made if the automatic backout of 
changes made to CICS/VS protected resources by transactions that 
subsequently fail is required: 

• The dynamic transaction backout program (DFHSG PBOGfiAM=DBP) must be 
generated. 

• AUTOJRN=YES must be specified in the file control program (DFHSG 
PROGRAH=FCP) if backout of CICS/VS recoverable files is required. 

• AUTOJRN=YES and DTB=AUX or MAIN must be specified in the journal 
control program (DFHSG PROGRAM=JCP). 

• If backout of recoverable transient data destinations is required, 
DESTRCV=YES must be specified in the transient data program (DFHSG 
PROGBAM=TDP). 

• If backout of recoverable auxiliary temporary storage identifiers 
is required, AUX=REC must be specified in the temporary storage 
program (DFHSG PROGSAH=TSP). 


CICS/VS EMERGENCY RESTART 


The following specifications should be made if the CICS/VS emergency 
restart facility is required: 

• BHSRCVR=YES must be specified in DFHSG PROGRAH=BMS if recovery of 
BHS messages is required. 

• AUTOJRN=YES must be specified in DFHSG PROGRAM=FCP if backout of 
CICS/VS recoverable files is required. 

• AUTOJRN=YES must be specified in DFHSG PROGRAM=«JCP. 

• DESTRCV=YES must be specified in DFHSG PROGRAM=TDP if backout of 
recoverable transient data destinations is required. 

• AUX=RBC must be specified in DFHSG PROGRAM=TSP if backout of 
recoverable auxiliary temporary storage identifiers is required. 

• RESEND=YES must be specified in DFHSG PROGRAH=RSP if re¬ 
presentation of committed output messages to logical units is 
required. 

• AKP=YES must be specified in DFHSG PROGRAH=KPP. 

• The transaction backout program (DFHSG PROGRAN=TBP) must be 
generated. 
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Chapter 2.4. Generating DL/IF acilities 


This chapter summarizes points the system programmer must bear in mind 
when generating a CICS/VS system with DL/I facilities. The requirements 
for CICS/DOS/VS and CICS/OS/VS are discussed separately. 


DL/I WITH CICS/DOS/VS 


Generation of DL/I support for CICS/DOS/VS systems requires the 
following steps: 

• The DL/I DOS/VS online system must be generated as described in the 
DL/I DOS/VS Utilities and Guide For The System Programmer manual. 

• CICS/DOS/VS must be generated with DL/I support as follows: 

- DFHSG TYPE=IMITIAL must include DLI (or DL1)=IES. 

— The journal control program (DFHSG PBOGBAM=JCP) must be 

generated if DL/I logging is to be performed on the CICS/DOS/VS 
system log rather than on the DL/I DOS/VS log. 

| — The DLI=YBS operand must be specified with the DFHSG 

j PBOGBAH=EXP and LANG=COBOL or PLI operands if the translators 

| for these languages are to handle EXEC DLI requests as well as 

| EXEC CICS commands. 

• DL/I data bases and application programs must be defined during the 
preparation of CICS/VS tables. Befer to Chapter 3.3 of this manual 
for further information. 


DL/I WITH CICS/OS/VS 


Generating DL/I support for CICS/OS/VS systems requires the following 
steps: 

• An IHS/VS Data Base System must be generated as described in the 
IHS/VS Version 1 System Programming Beference Manual . 

• CICS/OS/VS must be generated with DL/I support as described below. 

• The required CICS/VS system tables must be generated as described 
in Chapter 3.2 of this manual. 

The specifications required for generating DL/I support in CICS/OS/VS 
are: 

• DFHSG TYPE=IHITIAL must specify the level of the IHS/VS Data Base 

| System to be used. DL/I=1.1.5 or later is the only valid 

j specification for CICS/VS Version 1 Belease 5. 

Motes : 

(1) DLI or DLI may be specified. 
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(2) If a new release of IHS/VS is installed, it may be 

necessary to reassemble some CICS/VS DL/I modules. For a 
complete list of the modules affected refer to Appendix A 



• The journal control program (DFHSG PROGRAM=JCP) must be generated. 
All DL/I log records are written to the CICS/VS system log. 

The following macros and operands must be specified during the system 
generation process to provide DL/I shared data base support in 
CICS/OS/VS: 

• DFHSG PROGRAM=ISC 

• DFHSG PROGRAH=TCP with ACCHETH=IRC 

• DFHSG PROGRAM=CSO must be generated if any type of DL/I support is 
required in CICS/OS/VS. 

Information on the system table macros and operands that must be 
specified to provide DL/I shared data base support can be found in 
Chapter 3.4. 
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Part 3. Table Preparation 




Chapter 3.1. Introduction 


CICS/VS depends upon user—created system tables, which describe the 
user*s data base/data communications environment and the treatment to be 
given to the elements of that environment. Contained in the system 
tables is information on terminals, data sets (permanent and temporary), 
programs, and transactions. These tables are created independently of 
system generation. However, they are required for the system to be 
operational. 

CICS/VS is configured under user control during system 
initialization. The desired system tables are selected by the user, 
using standard naming and suffixing conventions described below. Each 
of the tables is created separately and can be recreated at any time 
prior to system initialization. More than one system table of each type 
(except the sign-on table) can be maintained at the same time. This 
allows the user to maintain special tables for testing in addition to 
the operational tables. 

Of these tables, the program control table (DFHPCT), the processing 
program table (DFHPPT), the system initialization table (DFHSIT), and 
the terminal control table pFHTCT) must be generated. The other tables 
are only needed if the corresponding CICS/VS facilities are to be used. 

The tables are named in the following manner: 


Table 

Name 

Application load table 

DFHALTxx 

Destination control table 

DFHDCTXX 

File control table 

DFHFCTxx 

Journal control table 

DFHJCTXX 

Monitor control table 

DFHMCTxx 

Nucleus load table 

DFHNLTXX 

Program control table 

DFHPCTxx 

Program list table 

DFHPLTxx 

Processing program table 

DFHPPT XX 

System initialization table 

DFHSITxx 

Sign—on table 

DFHSNT 

System recovery table 

DFHSRTxx 

Terminal control table 

DFHTCTxx 

Terminal list table 

DFHTLTxx 

Temporary storage table 

DFHTSTxx 

Transaction list table 

DFHXLTxx 


The first six characters of the name are standard for each of the 
tables. Except for the sign—on table, the last two characters (xx) may 
be specified by the user through the SUFFIX operand to allow several 
| versions of a table to be maintained; any one or two characters (other 
| than NO and DY) are valid. The suffix that the user assigns to a table 
is used to determine which version of that table is to be loaded into 
the system during system initialization. 

The system tables are prepared (generated) by assembling the 
appropriate macro instruction with its associated operands. For a 
description of the symbols and format used in CICS/VS macro 
instructions, see Chapter 1.1. 

The output of each macro instruction assembly contains the required 
linkage editor control statements. 
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CICS/VS will automatically generate the address of the entry point of 
each table through the DFHVM macro that is generated from each 
| TYPE=INITIAL macro* The entry point label of the table will be 
| DFHxxxBA. Only the END statement need be specified. A label (for 
j example, DFHTCTBA) need not be provided, unless the table (where 
I appropriate) is to be entry-point—aligned. 

See the appropriate CICS/VS System Programmer's Guide for details 
concerning the assembly and link—editing of the tables. 

A description of the macro instructions for each of the system tables 
follows in Chapter 3.2. 

Chapters 3.3 and 3.4 contain information on how to provide the 
recovery/restart and DL/I facilities in CICS/VS system tables. This 
information should be used in conjunction with the equivalent system 
generation information in Chapters 2.3 and 2.4. 

The CICS/VS system table macro instructions in Chapter 3.2 are 
arranged in alphabetic order by table acronym. The elements of each 
table, however, are presented in a logical order because an alphabetic 
ordering would disrupt the rationale behind the structure of each macro. 
Thus, most of the table preparation macros are presented in the 
following manner: 

• DFHXXX TYPE=INITIAL 

• DFHXXX TYPE=ENTRY 

• DFHXXX TYPE=FINAL 

All CICS/VS tables (except DFHSIT) must have TYPE^INITIAL and 
TYPE=FINAL as the first and last macros to be coded. 

Some tables, however, have a more complex structure. Two examples of 
this are the file control table (DFHFCT) and the terminal control table 
(DFHTCT). The introductory paragraphs to each such macro describe its 
structure. 

The operands within each macro are listed in the manner described in 
Chapter 1.1. However, in the case of certain parts of the file control 
table, the program control table, and the terminal control table, the 
optional operands are presented alphabetically on an access method basis 
in the syntax display. 

The discussion of each table (with the exception of DFHALT and 
DFHSIT) is concluded by an example of the coding for a typical table. 

N ote : The STARTER=YES parameter is an internal operand, which is 
reserved for use by IBM. It is documented here for reasons of 
completeness and clarity only. 
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Chapter 3.2. Table Preparation 


This chapter contains information on the macros and operands that are 
used to generate the CICS/VS system tables. The tables are presented 
in alphabetic order of table acronym. 

Certain operands appear in many of the system tables without 
alteration to their meaning. These operands are listed in the syntax 
display for the table with a reference to this page for a description of 
the operand. The operands in question are: 

• TYPE=INITIAL 

establishes the control section into which the CICS/VS system 
table is assembled , and produces the necessary linkage-editor 
control cards. 

• SUFFIX=xx 

specifies the suffix (one or two characters except NO and DY, 
which are reserved) for the CICS/VS system table. This suffix 
will be appended to the basic name (DFHxxx) and is used to name 
the module on the linkage-editor output library. 


ALT — APPLICATION LOAD TABLE 


The application load table enables the user to use virtual storage 
efficiently by allowing the user to control the order of loading 
application programs at system initialization. 

The application load table is an optional feature. If it is not 
used, application programs will be loaded in an order dependent on 
parameters in the processing program table (PPT)* If the application 
load table is used, the application programs specified in the table will 
be loaded first. Any programs in the PPT specified as permanently 
resident but not specified in the ALT will be loaded with the options 
specified in the PPT. 


CONTROL SECTION — DFHALT TYPB=INITIAL 


The control section for the application load table is established by the 
DFHALT TYPE=INITIAL macro instruction. 


| | IDFHALT | TYPE=INITIAL 

|| | | [,SUFFIX=xx) 

L_I_■■ -- . . 

| * See the first page of this chapter. 


* I 

♦ I 

_j 
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PROGRAM LOAD SEQUENCE — DFHALT TYPE=ENTRY 


The DPHALT TYPE 2 ENTRY macro instruction is used to add entries to the 
application load table. 


I 


| IDFHALT | TYPE=ENTRY | 

| | | ,PROGRAM 2 (name[,...]) | 

| | | [,ALIGN 2 {NO|BNTRYIYES}3 I 

| | | r.CLASS 2 (SPECIFIC I GENERIC! 1 | 

I I I [»FIX 2 {NO I YES} ] | 

| | | [,PAGEOUT 2 {NO| YES} ] | 

I I I I 

| | | CICS/DOS/YS only | 

III I 

I I I [,ADRSPCE 2 {HIGH|LOW}] | 

I_I_I___I 


TYPE=ENTRY 

indicates that an entry is to be added to the application load 
table. 


| PROGRAM 2 (naoe[ ,...]) 

specifies the program name(s) to be added to the application 
load table (multiple names may be specified and one entry will 
be created for each name). 


ALIGN 2 {NO|ENTRY|YES} 

specifies whether the programs are to be page—aligned. The 
default is NO. 

NO 

specifies no page-alignment. 

ENTRY 

specifies that the entry point of the module will ne loaded 
on a page boundary. This is useful when the working set of 
the module follows the module entry point and the entry 
point is not at the start of the module. In CICS/DOS/VS, 
ALIGN=ENTRY may only be used when ADRSPCE=LOW is specified. 


YES 

specifies that the module will be loaded on a page 
boundary. When ADRSPCE=HIGH (DOS/VS only) is specified or 
defaulted in this macro, the end of the program will be 
aligned on a page boundary. For ADRSPCE=LOW and for 
CICS/OS/VS, the beginning of the program will be page- 
aligned. 


CLASS 2 {SPECIFICIGENERIC} 

specifies whether the program names in this entry are to be 
treated as specific program names or generic program names. 

The default is SPECIFIC. 

SPECIFIC 

causes the individual program in the processing program 
table with the name specified by this application load 
table entry to be loaded with the options specified by this 
entry. 
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GENERIC 

causes all programs in the processing program table with 
names beginning with the characters specified by this 
application load table entry to be loaded, by the sequence 
in the PPT, with the options specified by this entry. 


FIX= {NO | Y E S} 

specifies whether the programs are to be page—fixed, 
default is NO. 


The 


NO 

indicates that page—fixing is not required. 


YES 

indicates that pages are to be page fixed. If this option 
is specified in 0S/VS, the appropriate SVC routine must be 
generated in the operating system through the CICSSVC 
operand of DFHSG TYPE=INITIAL. 


PAGEOUT={NO|YES} 

specifies whether CICS/VS is to force the program (s) out of 
real storage when not in use, and subsequently force the page 
that contains the program entry point in when the program is 
needed. The default is NO. 


indicates that no paging operations are to be performed. 

YES 

indicates that page—out and page—in operations are to be 
performed for this program. PAGEOUT=YBS also causes page- 
alignment of the program, to ensure that other programs are 
not inadvertently affected by the page-out reguest. 

However, if the next entry in the application load table is 
not page—aligned, it may be totally or partially included 
in the page-out of the previous program. If this option is 
specified in OS/VS, the appropriate SVC routine must be 
generated in the CICSSVC operand of DFHSG TYPE=INITIAL. 


CICS/DOS/VS Only 


ADRSPCE=f HIGH [LOW} 

specifies whether the program is to be loaded in high address 
space or low address space within the virtual partition. The 
end of the program will be page—aligned when ADRSPCE=HIGH is 
specified. The default is HIGH. 


END OF APPLICATION LOAD TABLE - DFHALT TYPE=FINAL 


The end of the application load table is indicated by the DFHALT 
TYPE=FINAL macro instruction. This is the last statement in the 
assembly of the application load table before the assembler END 
statement. 

i i ' r .. ... ~ 1 . . ■* 

| IDFHALT | TYPE=FINAL | 

I_I_L-1 
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TYPE=FINAL 

specifies that this is the last entry to be accepted by this 
application load table. This entry will also generate a dummy 
entry to be used as an end—of—table indicator. 


DOT — DESTINATION CONTROL TABLE 


The destination control table (DFHDCT) is used to describe to CICS/VS 
the destination name and certain other characteristics of data that is 
transient to CICS/VS (that is, to be processed by the transient data 
control program) and which can be queued. Entries are made to the DCT 
by generating the destination control table macro instruction (DFHDCT). 

The following macro instructions are available to define the 
destination control table entries: 

• DFHDCT TYPE=1NITIAL, which establishes the control section 

• DFHDCT TYPE=EXTRA, which specifies extrapartition destinations 

• DFHDCT TYPE=INDIRECT, which specifies indirect data destinations 

• DFHDCT TYPE=INTRA, which specifies intrapartition destinations 

• DFHDCT TYPE=REMOTE, which describes remote transient data 

| destinations when CICS/VS intercommunication facilities are used. 

• DFHDCT TYPE=SD5CI, which specifies the data set control information 

• DFHDCT TYPE=FINAL, which concludes the entries for the destination 
control table. 

Sequential extrapartition destinations are used for storing data that 
is external to the CICS/VS partition/region or for retrieving data from 
outside the partition/region. Data stored for this purpose includes 
data received from terminals or data created internally as the result of 
some transaction requirement identified by a user-written program. 
Extrapartition data may be both input and output data and is processed 
using QSAM under CICS/OS/VS or SAM under CICS/DOS/VS. It may also, for 
example, be a printer destination such as SYSLST in CICS/DOS/VS. 

Destination control table macro instructions are also used to specify 
intrapartition destinations. A single data set is used to hold the data 
for all intrapartition destinations. Intrapartition data may be 
ultimately either transmitted upon request to a destination terminal or 
retrieved sequentially from the intermediate data set for other uses. 

The user can specify, through the destination control table, that a task 
is to be created when a certain number of records (the "trigger level") 
has been accumulated for an intrapartition destination. 

The intrapartition destination may be defined as being either 
logically or physically recoverable. Logically recoverable destinations 
are recovered after an individual transaction or after total system 
failure, to the status they had at the start of the transaction that was 
processing them when the failure occurred. Physically recoverable 
destinations are recovered, after a total system failure, to the status 
they had when the system failure occurred. 

Included in the destination control table is the appropriate user- 
prepared data set control information for all resident extrapartition 
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data sets. This data set control information must follow the DFHDCT 
TYPE=INITIAL macro instruction. The extrapartition data sets supported 
under CICS/VS are: blocked or unblocked, fixed or variable—length. 

CICS/VS allows, in conjunction with the dynamic open/close facility, 
nonresident (transient) data set control blocks and associated 
input/output areas and logic modules. Main storage normally occupied by 
these storage areas is therefore available to the dynamic main storage 
area until the use of the storage areas is required. Nonresident data 
set control blocks are defined through the combination of DFHDCT 
TYPE=INITIAL and DFHDCT TYPE=SDSCI macro instructions. 

Whether the specified destinations are extrapartition or 
intrapartition (or indirect destinations pointing to either 
extrapartition or intrapartition destinations) , the symbolic names of 
the destinations must be provided by the user. CICS/VS uses several 
extrapartition destinations for its own purposes. These entries must be 
included in the generation of the DCT. Refer to Appendix A for details 
of the required entries. 


CONTROL SECTION — DFHDCT TYPE=INITIAL 


The entry point and beginning address for the destination control table 
being defined are established by the DFHDCT TYPE=INITIAL macro 
instruction. 


| | IDFHDCT | TYPE=INIT IAL * 

I I I [, INDEX = {NO | YES} ] 

| | | [ , SEPASMB= {NO | YES} ] 

| I | | [ , SUFFIX=xx] * 

| | | [ ,TRNSUFX= (xx[ ,XX ], . • .) } 

I I I 

| | | CICS/DOS/VS Only 

I I I 

| | | [,DEVICB={2314|3330|3340|3350} ] 


| * See the first page of this chapter. 


INDEX= {NO | YES} 

specifies whether indexing will be used. The default is NO. 

In some circumstances, indexing reduces the number of processor 
cycles required to search CICS/VS tables by shortening the scan 
to locate entries. It also reduces the CICS/VS working set for 
large tables by reducing references to little—used or unused 
pages, or pages between the referenced entry and table start. 
For further information, refer to the appropriate CICS/VS 
System Programmer^ Guide . 

NO 

indicates that indexing will not be used. 
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YES 


indicates that indexing will be used. When this option is 
chosen, an alphabetically ordered list of destination names 
is generated as part of the expansion of the DFHDCT 
TYPE=FINAL macro. 

Note: Page—indexing (the former PAGENXD operand) is no longer 

supported. However, if PAGENXD=YES is specified and the INDEX 
operand does not appear, the entries will be treated as if 
INDEX=YES were specified. 


SEPASMB={NO|YES} 

indicates whether a full destination control table is to be 
generated or whether only data set control information for 
nonresident data set definition is to be generated. The 
default is SEPASMB=NO 

NO 

indicates that a full destination control table is to be 
generated with data set control information. 

YES 

indicates that only the DFHDCT TYPE=INITIAL, DFHDCT 
TYPE=SDSCI, and DFHDCT TYPE=FINAL macro instructions are 
are to be included in this destination control table. This 
option does not generate a full destination control table. 
For further information on the use of the SBPASMB=YES 
option, refer to the section on "Nonresident Data Set 
Definition 11 at the end of the description of the 
destination control table. 


TRNSUFX= (XX[ ,XX ],...) 

specifies a list of one— or two-character alphanumeric suffixes 
associated with nonresident data set control blocks. Any 
suffix subsequently appearing in the SUFFIX operand of the 
DFHDCT TYPE=SDSCI macro instruction must also appear in this 
list. These suffixes are used to punch the control cards for 
the linkage—editor (LNKEDT). Up to 255 suffixes can be 
specified. 

Note: During link-edit of DFHDCT, there is one unresolved 
ADCON in each phase created under the direction of TRNSUFX in 
DFHDCT TYPE=INITIAL. This message does not imply an error. 


CICS/DOS/VS Only 


DEVICE=(2314|3330|3340|3350} 

specifies the type of device on which the DAM intrapartition 
data set resides. The default is DEVICE=2314. This operand 
replaces the DEVICE operand that was formerly in DFHSG 
PROGRAM=TDP• 

Note : If DFHSG PROGRAM=TDP is generated with INTRA=VSAM, the 

device type specified in this operand will be ignored at 
execution time and need not be specified. The default of 
DEVICE=2314 will nevertheless be applied and the resulting 
MNOTE can be ignored. 
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BXTB APART IT ION DESTINATIONS DPHDCT TYPE=EXTRA 


Destinations external to the CICS/VS system (but which are allocated to 
CICS/VS) are specified in the DFHDCT TYPE=EXTRA macro instruction. This 
macro instruction must be generated once for every extrapartition 
destination. 

| When CICS/VS intercommunication facilities are used, destinations 
that are not allocated to this CICS/VS system but which are required for 
| access by this CICS/VS system are defined to be in another CICS/VS 

system through the DFHDCT TYPE=REMOTE macro, which appears later in the 
discussion of this table. 

Extrapartition destinations that use nonresident data set control 
blocks are not required to be associated with a specific data set 
definition. When such destinations are opened, a one— or two—character 
suffix must be supplied to the dynamic open/close program that indicates 
which nonresident data set control blocks are to be used for the 
destinations. 

Note : 

Any destination identification (DESTID) of more than four characters is 
truncated on the right. The name must not start with the letter ,I C M , 

| which is reserved for CICS/VS, except to define one of the special 
| destinations. This applies to DFHDCT TYPE=BXTRA, TYPE=INDIRBCT, and 
j TYPE=INTRA. Refer to Appendix A for a listing of the special 
destination identification entries. 


i-1-1---1 

| IDFHDCT | TYPE=EXTRA | 

| | | ,DESTID=name | 

| | | [ ,DSCNAME=name] | 

| | | [ ,OPEN= {INITIAL| DEFERRED} ] | 

I I I r,BESIPNT=sfYESIN01 1 | 

I I I I [ ,RSL={01 number} I 

i-1-_i-1 


TYPE=EXTRA 

| indicates an extrapartition destination. 


DESTID=name 

specifies the symbolic name of the extrapartition destination. 
The symbolic name is the same as that used in the transient 
data operations to specify the destination. 


DSCNAME=name 

| specifies the file name the user must include in DFHDCT 

TYPE=SDSCI for destinations that use resident data set control 
blocks. This operand is not applicable for destinations that 
use nonresident data set control blocks. Nonresident data set 
control blocks are identified when the destination is opened. 


OPEN= {INITIAL | DEFERRED} 

specifies how the data set associated with this destination is 
to be opened. The default is OPEN=INITIAL. This operand 
applies only to extrapartition destinations that use resident 
data set control blocks. 
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INITIAL 

indicates that the data set is to be opened during system 
initialization. 

DEFERRED 

indicates that the user will open the data set during 
execution of CICS/VS. 


RESIDNT={YES|NO} 

indicates whether this destination is to use resident or 
nonresident data set control blocks. The default is 
RESIDNT^YES. 

YES 

indicates resident data set control blocks. 

NO 

indicates nonresident data set control blocks. 

The CICS/DOS/VS extrapartition data sets that are closed and 
I reopened by the dynamic open/close function of either the 

| master terminal program, or a user application program, must be 

defined as nonresident, or unpredictable results may occur. 

See "Nonresident Extrapartition Data Set Definition” at the end 
of the description of this table. 


| RSL= {0|number} 

| is a decimal value in the range 1 through 24 that defines the 

| resource level security associated with this resource. 


INDIRECT DATA DESTINATIONS — DFHDCT TYPE=INDIRECT 


Indirect data destinations can be specified within the destination 
control table by using the DFHDCT TYPE=INDIRECT macro instruction. The 
indirect data destination does not point to an actual data set but to 
another destination. This may be an extrapartition, an intrapartition, 
or a remote destination, or another indirect destination. 

For example, assume that the user develops functional symbolic names 
for the destinations of several message types. These, in turn, may 
point to one actual destination. At a later time the user might choose 
to direct one of the message types to another destination. The user 
does not change the programs but only alters the indirect destination 
name. 


4 

1- 

~r 



1 

| DFHDCT 

i 

TYPE=INDIRECT 


1 

i 

i 

,DESTID=name 


1 


i 

,INDDEST=name 


■_ 

i_ 

-L 




TYPE=INDIRECT 

indicates an indirect destination. 
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D£STID=name 

specifies the four—character symbolic name of a particular 
indirect destination. The symbolic name is the same as that 
used in the transient data operation. 


INDDEST=name 

specifies the symbolic identification of an intrapartition or 
extrapartition destination. This identification must De the 
same as the DESTID of the actual destination. If the name 
specified is not defined in the DCT, an assembly error will 
result. 


INTRAPARTITION DESTINATIONS — DPEDCT TYPE=INTRA 


Destinations for messages that are to be logged temporarily by CICS/VS 
are specified using the DFHDCT TYPE=INTRA macro instruction. This macro 
instruction must be specified once for every intrapartition destination. 


i-1-r-1 



IDFHDCT 

i 

TYPE=INTRA 



i 

i 

,DESTID=name 



i 

i 

[ ,DESTFAC=(TERMINAL 1FILE} 1 




i 

[,DESTRCV={NO|PH|LG}] 



i 

i 

[,REUSE={YES|NO}] 



i 

i 

[,RSL={0|number} 



i 

i 

[,TRANSID=name] 


1_ 

i 

i_ 

i 

[ ,TRIGLEV = {11 number} ] 

A 


TYPE=INTRA 

indicates an intrapartition destination. 


DESTID=name 

specifies the symbolic name of the intrapartition destination. 
The symbolic name is the same as that used in the transient 
data operation to specify the destination. 

If the ultimate destination of the data is a terminal and if 
automatic task initiation is associated with the destination, 
the name specified in the DESTID operand must be the same as 
the name specified in the TRMIDNT operand of DPHTCT 
TYPE=TEREINAL• The user may find it convenient to use the same 
naming convention for terminal destinations and data set 
destinations, regardless of whether automatic task initiation 
is requested. 


DESTFAC={TERMINAL|PILE} 

specifies the type of destination that the queue represents. 

The default is DESTFAC=TERMINAL• 

TERMINAL 

indicates that the transient data destination is to be 
associated with a specific terminal. If automatic task 
facility is used, as specified in the TRANSID and TRIGLEV 
operands, the transaction initiated will be associated witn 
the specified terminal, which must be available before the 
transaction can be initiated. 
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FILE 


indicates that the transient data destination is to be used 
as a file of data records, which are not associated with a 
particular terminal. Automatic task initiation does not 
require a terminal to be available. 


DESTRCV={NO|PH|LG} 

indicates the recoverability attributes of the destination in 
the event of an abnormal termination of CICS/VS. The default 
is DESTRCV=NO• 

NO 

indicates that this destination is not recoverable and that 
automatic logging is not to be performed to keep track of 
accesses to this destination. 


PH 

indicates that this destination is physically recoverable 
and that automatic logging is to be performed to keep track 
of accesses by application programs. In the event of 
emergency restart, this destination is to be recovered to 
its status at the time CICS/VS terminated. 

LG 

indicates that this destination is logically recoverable 
and that automatic logging is to be performed to keep track 
of accesses by application programs. If a transaction that 
had accessed this destination was in-flight at the time of 
abnormal termination, in the subsequent emergency restart 
or dynamic transaction backout this destination is to be 
restored to the status it would have had if the in-flight 
transaction had not modified it. 

Notes ; 

1. In the following notes and in the description of the REUSE 
operand (below), intrapartition storage is referred to as 
tracks. When intrapartition data is processed under VSAM, 
the storage is allocated in control intervals, when it is 
the VSAM control intervals that may be defined as being 
reusable. 

2. If the destination is specified with RE0SE=YES and 
DESTRCV=NO, a track is released as soon as the last record 
on it has been read. 

3. When REUSB=YES and DESTRCV=PH are specified for a 
destination, a track is released during the next GET after 
the GET that read the last record. 

4. For REUSB=YES and DESRCV=LG, a track is not released until 
the end of the task, or until after the next user-specified 
sync point. 
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5. If DESTRCV=LG is specified, when this destination is 

accessed, the record being read or written will be enqueued 
upon. This enqueue will be maintained until the task 
terminates or issues a DFHSP macro to signal the end of a 
logical unit of work. This is necessary to ensure the 
integrity of the data being accessed. Because the enqueues 
are thus maintained for a longer period of time, the 
potential for an enqueue lockout exists if an application 
program that accesses this destination performs what is 
effectively more than one logical unit of work against it 
without defining each separate logical unit of work to 
CICS/VS by issuing the sync point request. Furthermore, 
when a PURGE request is issued for a logically recoverable 
queue, the input and output ends of the gueue are enqueued 
upon. This increases the probability of an enqueue 
lockout. 


REUSE={YES|NO} 

specifies whether the storage tracks are to be reused. The 
default is REUSE=YES. 

YES 

indicates that intrapartition storage tracks for this 
destination are to be released after they have been read 
and returned to the pool of available tracks after the 
logical unit of work that read them has terminated. 

NO 

indicates that intrapartition storage tracks for this 
destination are not to be released until a transient data 
purge request is issued; this causes all tracks associated 
with this DESTID to be released. If DESTRCV=LG is 
specified, tracks will not be released until the next sync 
point; otherwise tracks are released immediately. 


| RSL={0|number} 

| indicates the security level, in the range 1 to 24, to be 

| associated with this resource (the intrapartition destination)• 

j The default is RSL=0. 


TRANSID-name 

identifies the transaction that is to be automatically 
initiated when the trigger level is reached. The purpose of 
transactions that are initiated in such a way is to read 
records from the destination. If this operand is omitted, or 
if TRIGLEV=0 is specified, some other means must be employed to 
schedule transactions to read records from the destinations. 

I Note ; This transaction may not reside in a remote CICS/VS 

| system. If it does, an ACRA abend will occur when an attempt 

| is made to initiate it. 


TRIGLEV=Q| number) 

specifies the number of data records (the "trigger level") to 
be accumulated for a destination before automatically 
requesting the creation of a task to process these records. If 
the TRANSID operand has been used, and if no trigger level has 
been specified, TSIGLEV defaults to a value of 1. The maximum 
| that can be specified is 32767. 
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If the DESTFAC operand specifies TERMINAL, the task will not he 
initiated until the associated terminal (with the same name as 
that specified in DESTID) is available; the terminal will be 
connected to the task that has been initiated. If the DESTFAC 
operand specifies FILE, no terminal is necessary for the task 
to be initiated. If the execution of a transient data write 
reguest results in the trigger level being reached (or 
exceeded) for a non-terminal destination, and if either a 
••maximum tasks 11 or H short-on—storage" condition exists for 
CICS/VS, the task to be automatically initiated is not 
initiated until a subsequent write request to the same 
destination occurs with the stress condition no longer 
existing. 

During CICS/VS operation the trigger level can be changed by 
| means of the CSMT or CEMT transaction issued by the master 

terminal operator (see the CICS/VS Operators Guide ). If the 
trigger level is reduced to a number equal to or less than the 
number of records accumulated so far, the task will be 
initiated when the next record is put to the destination. 


REMOTE TRANSIENT DATA DESTINATIONS — DFHDCT TYPE=REMOTE 


Remote transient data destinations, which are used by the CICS/VS 
| intercommunication facilities, are described to the destination control 
table by means of the DFHDCT TYPE=REMOTE macro. 


i-1-1- 

| |DFHDCT | TYPE=REMOTE 

| | | ,DESTID=name 

| | | ,SYSIDNT=name 

| | 1 [,LENGTH=length] 

| | | [,RMTNAME=name] 

|| | | [,RSL={0|number}] 

I 1 - 1 - 1 - 


TYPE=REMOTE 

indicates that this DCT entry identifies a remote transient 
data destination. 


DESTID=name 

provides a four—character name by which the destination is 
| known to application programs in the local system or region. 


SYSIDNT=name 

| specifies the four—character alphanumeric name of the system or 

| region in which the remote transient data destination resides. 

The name specified must be the same as that given in the 
| SYSIDNT operand of the DFHTCT TYPE=SYSTBM macro, or in an 

explicit remote request in an application program. 
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LENGTH=length 

indicates the length in bytes of fixed records for a remote 
destination. The value specified must correspond to that 
| specified for the DCT in the system or region in which the 

destination resides. If a value is not specified for the 
LENGTH operand, the LENGTH parameter must be given in READQ or 
WRITEQ requests in the application program. 


RMTNAME=name 

| indicates the one— to eight—character name by which the 

| destination is known in the system or region in which that 

destination resides. If this operand is omitted (the normal 
case), the name specified in the DESTID operand is used. The 
RMTNAME operand allows two destinations, with the same name but 
| in different systems or regions, to be referenced. 


| RSL = {01 number} 

| indicates the security level, in the range 1 to 24, to be 

| associated with this resource. The default is RSL= 0. 


DATA SET CONTROL INFORMATION — DFHDCT TYPE=SDSCI 


The data set control blocks (DTFs in CICS/DOS/VS; DCBs in CICS/OS/VS) 
are generated in response to the DFHDCT TYPE=SDSCI macro instruction. 
This macro instruction is only needed for extrapartition transient data 
and must have a DFHDCT TYPE=EXTRA macro instruction associated with it 
for resident data set control blocks. Note that all DFHDCT TYPE=SDSCI 
macro instructions must be issued immediately following the DFHDCT 
TYPE=INITIAL macro instruction and preceding any DFHDCT TYPE=EXTRA, 
DFHDCT TYPE=INTRA, DFHDCT TYPE=INDIRECT, or DFHDCT TYPE=REMOTE macro 
instructions. 


r 

r 



-1 


IDFHDCT 

» 

TYPE=SDSCI 



i 

i 

,DSCNAHB=name 



i 

i 

[,BLKSIZE=length] 



i 

i 

[,BUFNO={1|number}] 



i 

i 

[ ,ERR0PT= (IGNORE|SKIP} } 



i 

i 

T.RECFORM^ fFIXUNBIFIXBLK1VARBLK1VARUNB1 } 



i 

i 

[,RECSIZE=length] 



i 

i 

[,REWIND={LEAVE|NORWD|REREAD|ONLOAD}] 



i 

i 

[,SUFFIX=xx] 



i 

I 

i 

l 

r *TYPEFLE= flNPUTIOUTPUTIRDBACK1 ^ 



1 

i 

1 

1 

i 

1 

CICS/DOS/VS Only 



1 

i 

1 

i 

,DEVICE=device 



i 

i 

[,CTLCHR={TBS|ASA}] 



i 

i 

[,DEVADDR=symbolic—address] 




i 

[,FILABL={NO|STD}] 



i 

i 

[,MODNABB=name] 



i 

i 

[,TPMARK=N0] 


i 

i_ 

_u 


_1 


TYPE=SDSCI 

specifies data set control information. 
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DSCNAME=name 

specifies the data set control name. This name must be the 
same as that specified in the DSCNAME operand of any associated 
DFHDCT TTPE=EXTRA macro instruction and is limited to seven 
characters in CICS/DOS/VS or eight characters in CICS/OS/VS. 

For CICS/OS/VS, the name used for DSCNAME must be used as the 
ddname on the DD statement and will also be used as the name 
for the DCB which is created. In CICS/DOS/VS, this name must 
be the same as that specified on the DLBL system control 
statement. The name must not start with the letters H DFH W , 
which are reserved for use by CICS/VS, unless it is describing 
one of the standard destinations listed in Appendix A. Use of 
the prefix ,I DFH 11 may cause assembly errors and future 
compatibility problems for the user, because the DSCNAME 
parameter becomes an externally specified name. 


BLKSIZE=length 

specifies the length (in bytes) of the block (the maximum 
length for variable length records including four bytes for 
| LL/Z). For VSE disk output data sets, the eight bytes required 

I by logical IOCS for creation of the count field must be added. 


BUFNO=Q| number} 

specifies the number of buffers to be provided. The default is 
BUFhO=1 • For CICS/DOS/VS, any value other than 2 defaults to 
1. For CICS/OS/VS, any number up to 255 may be specified. 


ERROPT=(I GNORE I SKIP} 

specifies the error option to be performed in the event of an 
I/O error. The default is ERROPT=IGNORE• 

IGNOR E 

causes the block that caused the error to be accepted. 


SKIP 

causes the block that caused the error to be skipped. 


| RECFORM={FIXUNB|FIX BLK|VARBLK|VARUNB} 

I specifies the record format of the data set. The default is 

| RECFORM=FIXUNB* 

FIXUNB 

indicates fixed unblocked records. 

FIXBLK 

indicates fixed blocked records. 

VARBLK 

indicates variable blocked records. 

VARUNB 

) indicates variable unblocked records. 


RECSIZE=length 

specifies the length (in bytes) of the record (the maximum 
length for variable length records including four bytes for 
| LLjfp) . RECSIZE=length need only be specified for 

RECFORM=FIXBLK. 
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REWIND- {LEAVE|NORWD|REREAD|UNLOAD} 

indicates the disposition of a tape data set. 

LEAVE 

positions the current volume to the logical end of the data 
set (CICS/OS/VS only). 

NORWD 

indicates that the volume should not be rewound 
(CICS/DOS/VS only). 

REREAD 

positions the current volume to reprocess the data set 
(CICS/OS/VS only). 

UNLOAD 

indicates a rewind and unload of the current volume 
(CICS/DOS/VS only). 


SUFFIX=xx 

specifies a one— or two—character alphanumeric suffix for the 
nonresident data set control block being generated. The use of 
this operand indicates that the data set control block being 
generated is nonresident. Nonresident data set control blocks 
reside on the VSE private or system core—image library or the 
OS/VS CICS•LOADLIB under the unique name DFHTRNxx, where «xx« 
is the suffix specified in this operand. The user—provided 
suffix characters must also be specified in the DFHDCT 
TYPE=INITIAL,TRNSUFX=(xx,...) list. In addition, the order of 
SUFFIX=xx operands specified in successive macros must match 
that of the TRNSUFX specifications in DFHDCT TYPE=INITIAL, or 
unpredictable results will occur. 

For each data set control block generated using the DFHDCT 
TYPE=SDSCI,SUFFIX=xx macro instruction, the same suffixed name 
must be specified in the preparation of the program processing 
table (DFHPPT TYPE=ENTRY,PROGRAM=DFHTRNxx). 


TYPEFLE={INPUT|OUTPUT|RDBACK} 

specifies the type of data set. The default is TYPEFLE=INPUT. 
INPUT 

indicates an input data set. 

OUTPUT 

indicates an output data set. 

RDBACK 

indicates an input data set that is to be read backward. 

An extrapartition SDSCI can be either input or output, not 
both. System abend codes or unpredictable results may occur if 
output operations specify an input SDSCI or if input operations 
specify an output SDSCI. 
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CICS/DOS/VS Only 


DEVICE=device 

specifies the type of input/output device. Valid device types 
are: 1403, 1404, 1443, 1445, 2314, 3203, 3211, 3330, 3340, 

3350, PBA, 5203, and TAPE. This operand is ignored in 
CICS/OS/VS; instead, the device specified through the data 
definition (DD) statement is used. 


CTLCHR={YES| ASA} 

specifies the type of control character to be used for printer 
devices. The control character must be the first byte of the 
user—supplied record. It is no t supplied by CICS/VS. The 
default is no control character. This operand must not be 
specified for DEVICB=1403. 


DEVADDR=symbolic-address 

specifies the symbolic unit address. This operand is not 
required for disk data sets when the symbolic address is 
provided through the CICS/DOS/VS EXTENT card. 


FILABL= {NO | STD} 

specifies the type of label on tape data sets. The default is 
FILABL=NO. 

NO 

indicates that the tape data sets do not have standard 
labels. 

STD 

indicates that the tape data sets have standard labels. 


MODNAME=name 

specifies the name of the logic module to be used to process 
the transient data set. If this operand is omitted, a standard 
| VSE name is generated for calling the logic module. 

| This operand can be used in conjunction with the VSE 

subset/superset logic module facility to reduce the number of 
logic modules required to process sequential data sets (where 
supersetting is permissible). 


TPMARK=NO 

indicates that writing a tapemark at the beginning of a data 
set (file) is to be suppressed. When TPMARK=NO is specified, 
FILABL=NO is required. 

| For further information on the above operands, refer to VSE/Advanced 
I Functions Macro Reference or to 0S/VS Data Management Macro 
Instructions- 
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END OP DESTINATION CONTROL TABLE — DFHDCT TYPE=FINAL 


Entries for the destination control table are terminated by the DFHDCT 
TYPE=FINAL macro instruction. This macro instruction must be the last 
statement in the assembly of every destination control table before the 
assembler END statement. 

i-1-1-1 

| IDFHDCT | TYPE=FINAL | 

i_i_i_i 


TYPE=FINAL 

indicates the end of the destination control table. 


NONRESIDENT EXTRAPARTITION DATA SET DEFINITION 


Nonresident extrapartition data sets are defined through the DFHDCT 
TYPE=INITIAL and DFHDCT TYPE=SDSCI macro instructions. The data set 
control blocks and associated input/output areas are generated and 
cataloged to the DOS/VS private or system core—image library or the 
OS/VS CICS•LOADLIB as a separate table for each nonresident data set 
control block to be used. There must be an entry in the processing 
program table (PPT) for each nonresident data set control block. The 
format of the name is DFHTRNxx, where "xx" represents the suffix 
character (s) specified in the DFHDCT TYPE=SDSCI,SUFFIX=xx macro 
instruction. The PPT entry for these data set control blocks must 
include the RELOAD=YES operand. 

In CICS/OS/VS, the necessary access methods are acquired when data 
sets are opened. Therefore, references to transient access methods 
(logic modules) in the following discussion are applicable primarily to 
CICS/DOS/VS. 

| In VSE AF release 1.2 and later, the logic modules for a version 3 
| DTF will be in the SVA. Version 3 DTFs are generated for sequential 
| disk files, but not for magnetic tape files. 

In CICS/DOS/VS, the logic modules for the nonresident data set 
control blocks may also be transient. If the use of nonresident logic 
modules is required, the logic modules must be assembled and cataloged 
| to the VSE private or system core—image library prior to execution. The 
| logic modules are assembled using the standard VSE SAH macro 

instructions and must be cataloged with the same program name generated 
by the nonresident data set control block for which it is to be used. 

The name can be found in the assembly of the data set control block. 
Unless otherwise specified in DFHDCT TYPE=SDSCI, this name is the 
| standard VSE logic module name. 

The PPT entry required for each nonresident logic module must include 
the RELOAD=YES operand. 

In CICS/DOS/VS, if the DCT is generated to include the nonresident 
data set control block definitions, the logic modules for both the 
resident and nonresident data set control blocks are link-edited into 
the DCT. To allow the logic modules to be transient, the DCT must be 
assembled including only the resident data set control block definitions 
(DFHDCT TYPE=SDSCI). A separate assembly can then be accomplished to 
generate only the nonresident data set control blocks. This requires a 
DFHDCT TYPE=INITIAL,TRNSUFX= (xx,...) ,SEPASMB=YES macro instruction, 
followed by DFHDCT TYPE=SDSCI macro instructions for all nonresident 
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data set definitions, followed by the DFHDCT TYPE=FINAL macro 
instruction. 


EXAMPLES 


Figure 3.2—1 contains an example of the coding required to generate a 
destination control table that uses resident data set control blocks. 


DFHDCT TYPE=INITIAL, 
DEVICE=3340 
DFHDCT TYPE=SDSCI, 

DSCNAME=AAAXTRA, 
DEVADDR=SYSLST, 
DEVICE-1403, 
RECFORM=FIXUNB 
DFHDCT TYPE=EXTRA, 

DSCNAME=AAAXTRA, 
DESTID=CASH 
DFHDCT TYPE=INTRA, 

DEST ID=GAMA 
DFHDCT TYPE=INTRA , 
DESTID=SAMA 
DFHDCT TYPE=INTRA, 
DESTID=DAMA, 
TRIGLEV=5, 
DESTFAC=TERMINAL, 
TRANSID=AUTO 
DFHDCT TYPE=FINAL 
END 


START OF DESTINATION CONTROL TABLE * 


SPECIFY DATA SET CONTROL INFO * 

RELATED DESTINATION * 

SYMBOLIC UNIT ADDRESS * 

DEVICE TYPE * 

RECORD FORMAT 
EXTRAPARTITION DESTINATION 

SYMBOLIC NAME 
INTRAPARTITION DESTINATION * 

SYMBOLIC NAME 

♦ 

SYMBOLIC NAME 

* 

SYMBOLIC NAME * 

* 

* 

TRANSACTION ID 


END OF DESTINATION CONTROL TABLE 


Figure 3.2—1. DCT Using Resident Data Set Control Blocics 


Figures 3.2—2 and 3.2—3 show how the generation of a DCT can include 
extrapartition destinations that use nonresident data set control 
blocics. Figure 3.2—2 shows a DCT with nonresident data set control 
blocics and resident logic modules. Figure 3.2—3 shows a DCT with 
nonresident data set control blocks and nonresident logic modules. 

The assembly of the macro instructions contained in Figure 3.2—2 
results in a destination control table with suffix of 22 (DFHDCT22), 
which contains one data set control block for the printer (TYPE=SDSCI, 
DSCNAME=PRINT). When the output of this generation is link—edited, the 
logic modules for tape and printer are automatically included, and the 
I four tape data set control blocks are cataloged separately to the VSE 
private or system core—image library or OS/VS CICS.LOADLIB as DFHTRNAA, 
DFHTRNBB, DFHTRNCC , and DFHTRNDD. 

The extrapartition destination (DESTID=TAPE) can be opened through 
the CICS/VS dynamic open/close program with any of the four suffixed 
data set control blocks (DFHTRNAA, DFHTRNBB, DFHTRNCC, or DFHTRNDD). It 
can then be closed and reopened with any of the other nonresident data 
set control blocks• 

Program processing table (PPT) entries must be included for the four 
data set control blocks cataloged separately. PPT entries must include 
the RELOAD=YES operand. 
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DFHDCT TYPE=INITIAL, 

TRNSUFX= (AA,BB,CC,DD) , 
SUFFIX-22 

DFHDCT TYPE=SDSCI § 

DSCNAME=TAPE1, 
RBCFORM=FIXBLK 9 
TYPEFLE=OUTPUT, 
BLKSIZE=2000, 
DBVADDR=SYS011, 
DEVICE=TAPE, 

BUFN0=2, 

RECSIZE-200, 

SUFFIX=AA 
DFHDCT TYPE=SDSCI , 

DSCNAME=TAPE2, 
RECFORM^FIXBLK, 
TYPEFLE=INPUT, 
BLKSIZE-2000, 
DEVADDR=SYS011, 
DEVICB=TAPE, 

BUFNO=2, 

RECSIZE=200 r 

SUFFIX=BB 

DFHDCT TYPE=SDSCI, 

DSCNAME=TAPE3, 
RECFORM=FIXUNB , 
BLKSIZE=1240 , 

TY PEFLE=INPUT r 
DEVADDR=SYS011, 

DEVICE=TAPE, 

SUFFIX=CC 

DFHDCT TYPE=SDSCI, 

DSCNAME=TAPE4 9 
RECFORM=FIXUNB, 
BLKSIZE=1240, 
TYPEFLE=OUTPUT, 

DE VADDR=SY S011, 
DE¥ICE=TAPE, 

SUFFIX =DD 

DFHDCT TYPE^SDSCI, 

DSCNAME=PRINT, 
RECFORM=VARUNB, 
BLKSIZE=121, 
DEVADDR=SYSLST, 
DEVICE=1403 
DFHDCT TYPE=£XTRA, 

DSCN A ME =PR I NT , 

DESTID=PRNT 
DFHDCT TYPE=EXTRA, 

RESIDNT=NO, 

DESTID =TAPE 
DFHDCT TYPE=FINAL 
END 

Figure 3.2—2. DCT Using Nonresident 
Resident Logic Modules 
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DPHDCT TYPE-INITIAL, 

TRNSUFX- (AA, BB,CC,DD) , 
SEPASMBYTES 
DPHDCT TYPE-SDSCI, 

DSCNAME-TAPE1, 
RECFORM-FIXBLK, 

TYPEFLE-OUTPUT, 
BLKSIZE-2000, 
DEVADDR-SYS011, 
DEVICE-TAPE, 

BUFNO-2, 

RECSIZE-200, 

SUFFIX-AA 

DPHDCT TYPE-SDSCI, 

DSCNAME-TAPE2, 

RECFORM-FIXBLK, 
TYPEFLE-INPUT, 
BLKSIZE-2000, 
DEVADDR-SYS011, 
DEVICE-TAPE, 

BUFNO—2 , 

RECSIZE=200, 

SUFFIX-BB 

DPHDCT TYPE-SDSCI, 

DSCNAME-TAPE3, 
RBCFORM-FIXUNB, 
BLKSIZE-1240, 
TYPEFLE-INPUT, 
DEVADDR—SYS011, 
DEVICE-TAPE , 

SUFFIX-CC 
DPHDCT TYPE-SDSCI, 

DSCNAME-TAPB4, 

RECFORM-FIXUNB, 

BLKSIZE-1240, 

TYPEFLE-OUTPUT, 
DEVADDR-SYS011, 
DEVICE-TAPE, 

SUFFIX-DD 
DFHDCT TYPE=FINAL 
END 


DPHDCT TYPE-INITIAL, 

SOFPIX=YY 

DPHDCT TYPE-SDSCI, 

DSCNAME-PRINT, 
RECFORM-VARUNB, 
BLKSIZE=121, 
DEVADDR-SYSLST, 

DEVICB-1403 
DPHDCT TYPE-EXTRA, 

DSCNAME-PRINT, 
DESTID-PRNT 
DPHDCT TYPE-EXTRA, 

RESIDNT-NO, 

DESTID-TAPE 
DPHDCT TYPE-FINAL 
END 

Figure 3.2—3. DCT Using Nonresident 
Nonresident Logic Modules 
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The result of the generation of the macro instructions contained in 
Pigure 3.2-3 is a destination control table with a suffix of XX 
(DPHDCTXX). The DCT contains one data set control block for the printer 
(TIPS =SDSCl,DSCN AHE=PBINT) and one logic module for the printer. The 
four data set control blocks for tape are also generated by the assembly 
of the macro instructions contained in Figure 3.2—3. When the output of 
that assembly is link-edited, the data set control blocks are cataloged 
as DFHTBNAA, DFHTBNBB, DFHTBNCC, and DFHTBNDD. Bom ever, the user must 
have cataloged the logic modules used by these four data set control 
| blocks in the VSE private or system core—image library, and must have 
included entries in the PPT that specify the BELOAD=XES operand for 
those logic modules. 

When using the generated DCT of Figure 3.2—3, no storage is used for 
the data set control blocks or for the logic modules until the 
extrapartition destination (DESTID=TAPE) is opened using the CICS/VS 
dynamic open/close program (DFHOCP). The dynamic open/close program 
will ensure that only one logic module of the same name is in storage at 
any one time. If the logic module is not resident in the DCT, the 
dynamic open/close program frees the storage associated with the logic 
module when the data set is closed. 

For further details on the dynamic open/close facility, see the 
discussion of dynamic open/close in DFHS6 PBOGBAM=OCP in Chapter 2.2, 
and in the Dynamic Open/Close Function (DFHOC) in Chapter 7.2 of this 
manual. 


PCX — FILE CONTROL TABLE 


The file control table is used to describe to CICS/VS any user data sets 
(files) that are processed by file management. (Note that sequential 
data sets must be defined as extrapartition destinations by using the 
DFBDCT macro.) The DFBFCT macro instruction is used to generate entries 
for the table and to request the following services: 

• DFHFCT TXPE=INITIAL — to set up the open list for the data sets to 
be used when initializing and terminating the system. 

• DFHFCT TXPE=ALTEBNATE — to define the ICIP characteristics of data 
sets, which can be accessed by either normal VSAM or by VSAM ICIP. 
These are known as mixed mode files and can be used with the High 

| Performance Option (BPO) under 0S/VS2 Belease 3.8 (MVS). 

• DFHFCT TXPE=DATASET — to describe characteristics of the data sets, 
such as access method used, record characteristics, types of 
service allowed. 

• DFHFCT TXPE=INDACC — to define use of the data set as a cross—index 

and provide the information to locate the next data set through 

indirect access. 

• DFHFCT TXPE=LOGICMOD — to generate an ISAM superset module in-line 
as part of the file control table (CICS/DOS/VS only). 

• DFHFCT TXPE=BEMOTE — to define files that are resident in a remote 

| system or region when CICS/VS intercommunication facilities are 

j used. 

• DFHFCT TXPE=SEGDEF, TIPE=SEGHEAD, TXPB=SEGSET, and TXPB=SEGLAST - 
to define the segments and segment sets of a record. 


Chapter 3.2. Table Preparation 


101 



| • DFHFCT TYPB=SHRCTL — to allow a task to share resources that exist 

| in several VSAM data sets. 

• DFHFCT TYPE=FINAL — to terminate entries in the file control table. 

The data control information for each data set is included in the 
DFHFCT macro instruction. The indirect access and segmenting services 
are mutually exclusive; the entry for one data set cannot specify both 
services. 


CONFIGURATOR 


This section is intended to aid the system programmer in the preparation 
of the file control table (FCT) when using the DFHFCT TYPB=DATASBT macro 
instruction to describe the physical characteristics of the data sets. 
These descriptions include information about the access method (BDAN, 
DAM, ISAH, or VSAM) and record characteristics for the data sets. 
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R Required 

O Optional 

1 Required if relative type addressing is to be used. 

2 Required if main storage high-level index processing is used. 

3 Required if INDARBA is specified. 

4 Required only if a master index exists. 

5 Optional; used only if SERVREQ=NEWREC; for ISAM data sets 
under CICS/OS/VS, IOWORK should also be specified. 

6 If SERVREQ=BROWSE or SERVREQ=NEWREC, this value must be 
BLKSIZE plus BLKKEYL. 

7 Required if key exists within logical records. 

8 Required if deblocking by key for BDAM (CICS/DOS/VS and 
CICS/OS/VS); required for variable—length ISAH records in 
fixed—length blocks (CICS/DOS/VS only). 

9 SERVREQ=KEY is required. 

10 Required if there is an associated DFHFCT TYPE=ALTERNATE macro. 

See the section on mixed mode files. 

11 BUFND should not be specified. The number of data buffers will be 
set to the value in STRNO. 

12 Required for TYPE=DATASBT. Note that HODE= is not required for 
TYPE=ALTERNATE — see the section on mixed mode access, below. 

13 Required if ACCMETH= (VSAM,KSDS). 


CONTROL SECTION — DFHFCT TYPE=INITIAL 


The control section into which the file control table is assembled is 
established by means of the DFHFCT TYPE=INITIAL macro instruction, which 
must be coded as the first statement in the source deck used to assemble 
the file control table. 


r 


I I 
I I 


| DFHFCT | TYPE=INITIAL 
| | [,S0FFIY=xx] 


.1_L 


1 


* I 

* I 


| * See the first page of this chapter. 


VSAM ICIP MIXED MODE ACCESS — DFHFCT TYPE=ALTERNATE 
(MVS ONLY) 


A mixed mode file is one that is defined so that it can be accessed 
| either as a VSAM file or as a VSAM improved control interval processing 
| (ICIP) file when the High Performance Option (HPO) is used, that is when 
CICS/OS/VS contains the SRBSVC operand in DFHSG TYPE-INITIAL. 

To specify a mixed mode file, two consecutive DFHFCT macros must be 
generated. The first (TYPE=DATASET) defines the VSAM access 
characteristics, and the second (TYPE=ALTERNATB) defines the ICIP 
characteristics. 

The TYPE=DATASET macro defines the VSAM characteristics of the file 
by using the VSAM (non—ICIP) parameters of the file control table. In 
addition, the MODE parameter must be specified thus: 

M0DE= ({VSAM|ICIP}[ ,MIXED]), where VSAM is the default. NIXBD indicates 
that this is the first DFHFCT macro of a mixed mode pair, and describes 
the VSAM characteristics. VSAM or ICIP describes the mode in which the 
file is to be opened and subsequently accessed, when CICS/VS is 
initialized. For example, if VSAM is specified, the file will be opened 
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as a VSAM file with the characteristics defined in this file control 
table. If ICIP is specified, the file will be opened as an ICIP file 
with the characteristics defined in the TYPE=ALTERNATE macro that 
follows. 

The second mixed mode DFHFCT macro (which must immediately follow the 
first) has TYPE=ALTERNATE and defines the ICIP characteristics of the 
file, using the parameters described below. The DATASET name must be 
the same as that specified in the preceding TYPE-DATASET macro. The 
MODE operand need not be specified in this macro. Users are advised to 
study the examples of ICIP and mixed mode files, which are given at the 
end of the section on the file control table. 



|DFHFCT 

| TYPE=ALTERNATE 

-1 



| ,ACCHETH=(VSAtl[ ,KSDS|ESDS]) 




| ,DATASET=naiue 



i 

| ,SERVRBQ~ (request[ ,request ],...) 




j ,STRNO=number 



i 

| [,BUFND=number] 




| [,BOFNI=number] 




| [,DATA=nameJ 



i 

1 r ,INDEX= (naaer .numberf . fINITIDYNl 11) 1 



i 

| r ,JID={NO 1SYSTEMInnl 1 


1 . 'V 


| [,JREQ= {ALL|(request [,request, ...)]} ] 




| [,L0G={N0|YES}] 




j [,PASSWD=password] 



i 

| [,BECFOSM=([{FIXED|UNDEFINED|VARIABLE} ] 




| , [ {BLOCKED | D NBLOCKED} ]) ] 




| [ , STBNOG=uumber] 


1_ 

i_ 

-i_ 

_K 


TYPE=ALTERNATE 

indicates that the file control table defines the ICIP 
characteristics of a data set that can be accessed by either 
VSAM or by VSAM ICIP. 


ACCMETH=(VSAM[,KSDS |BSDS ]) 

specifies the type of VSAM data set to be accessed. The 
options are KSDS (key sequence data set) and BSDS (entry 
sequence data set). 


DATASBT-name 

specifies the name of the data set to be used for processing by 
either normal VSAM or by VSAM ICIP. This name must be the same 
as that specified in a preceding DFHFCT TYPE=DATASET macro with 
MODE=MIXED specified. 


SERVREQ=(reguest[,request},...) 

defines the types of service request that can be processed 
against the data set. The parameters that can be included are 
as follows: 

GET 

records on this data set may be read. 

PUT 

records may be written on this data set. 
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UPDATE 

I records may be updated on this data set. If UPDATE is 

I specified, both GET and PUT are implied and need not be 

| specified. 

The STRNO, BUPND, BUFNI, DATA, INDEX, JID, JREQ, LOG, PASSWD, RECFORM, 
and STRNOG operands are as described in the DFHFCT TYPE=DATASET macro 
instruction, below. 


DATA SETS — DFHFCT TYPE=DATASET 


The physical characteristics of a data set are described to CICS/VS file 
management by the DFHFCT TYPE=DATASET macro instruction. This macro 
instruction includes operands that provide information about the access 
method, record characteristics, and the types of service allowed for the 
data set. This information is used to generate a DTF or ACB for 
CICS/DOS/VS, or a DCB or ACB for CICS/OS/VS. 

If the DL/I facility of the IBM Information Management System/Virtual 
Storage (IMS/VS) is to be accessed under CICS/OS/VS or if DL/I is to be 
used under CICS/DOS/VS, the DFHFCT TYPE=DATASET macro instruction is 
used to provide information about Data Language/I (DL/I) data bases. 
DATASET and ACCMETH are the only operands reguired for DL/I data bases, 
although the OPEN operand can also be specified for CICS/DOS/VS. 

Physical characteristics of the DL/I data bases need not be specified 
| because they are specified during generation of IMS/VS or DL/I under VSB 
Data Base Descriptions (DBDs). A DFHFCT TYPE=DATASET entry must be 
| provided for each physical, logical, and index DL/I data base (that is, 

| for each DBD). The name specified in the DATASET operand must 
I correspond to the name in the NAME parameter for the DBD. 

The file control table entry defining a VSAM data set will require a 
minimum of specific information. Such values as logical record length, 
and relative key position will be obtained by system initialization 
after the data set is opened and placed in the CICS/VS portion of the 
file control table. 

The DFHFCT TYPE=DATASET macro instruction can include the operands 
shown below. Note that the optional operands are presented in the 
following manner in the syntax display: 

• Operands that apply to all access methods 

• Operands that apply to all access methods except VSAM 

• ISAM-only operands 

• DAM-only operands 

• VSAM—only operands 

• CICS/DOS/VS—only operands 

• CICS/OS/VS—only operands 

to allow the user to see which operands are applicable to the system on 
an access method basis. The descriptions of these optional operands are 
arranged alphabetically following the description of the required 
operands. 
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r -.- 

• 

r 

-, 


IDFHFCT 

| TYPE=DATASET 



i 

| ,DATASBT=name 



i 

1 »ACCHETH=fBDAH1 ISAM 1DL/11 (VSAMf .{KSDS1ESDSIRRDS) ] 



i 

| [ , ADR |KEY ]) } 



i 

| ,SEBVBEQ= (request[ ,request ], . . . ) 




1 r .FILSTAT= ({ENABLED 1 DISABLED) ,(OPENED1 CLOSED}) 1 




| [,JID={NO|SYSTEM|nn}] 



i 

| [,JREQ={ALL| (request[ , request, ... ])} ] 



i 

| [,LOG={NO|YBS} j 




1 F»OPEN=(INITIAL1 DEFERRED! 1 



i 

| [,RBCFORM=i[(UNDEFINED|VARIABLE|FIXED}] 




| [{,BLOCKED|DNBLOCKED}] 



i 

| [,DCB format][.DOSISAM])] 



i 

| [,RSL={0|number}] 

1 




1 Non—VSAM 

a 



1 

1 i 

| [,BLKKEYL=length] 



i 

| [ ,BLKSIZE= (length[ ,length]) ] 




| [,KEYLEN=length] 



i 

| [ ,LRECL=5 (length[ # length ]) ] 



i 

| [,RKP=number] 



i 

i 

| [,VERIFY=YES] 

1 



1 

i 

1 ISAM Only 
| 



i 

1 

| [,INDAREA=symbolic—name] { 



i 

| [,INDSIZE=length] 



i 

l 

| [ # IOSIZE=length] 

a 



i 

1 DAM Only 



1 

i 

| [,RELTYPE={BLK|DEC|HEX}] 



i 

| [ r SRCHM={YES|number}] 



1 

1 VSAM Only 
■ 



1 

i 

| [,BOFND=number] 



i 

| [,BUFNI=number] 



i 

| [,BOFSP=number] 



i 

j [,PASSND=password] 



i 

■ 

| [,STRNO= til number}] 



1 

i 

1 CICS/DOS/YS Only 

1 



1 

i 

| [,CYLOFL=number] 



i 

1 T ,DEVICE= (2314.2314) 1 fnr ,ml> 1 



i 

| [,EXTENT=number3 



i 

| [,INDSKIP=YES] 



i 

| [,MSTIND=YES] 



■ 

a 

| [,NRECDS=number] 

1 



l 

1 

1 CICS/OS/VS Only 

1 



I 

i 

| [ # BASE=name] 


i 

• 

i 

i [ # DATa=namej 



i 

| [ ,INDEX= (name[ # number[ # {INIT fDYN} ] ]) ] 



i 

j [ ,IOWORK=symboiic—name] 



i 

1 r #MODE= ( fVSAM 1 ICIPir .MIXED 1) 1 



i 

| [ ,STRNOG=nu»ber] 


i _ 

i- 

_i------- 

_» 
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TYPE=DATASET 

specifies the data sets in the system. 


DATASET-name 

specifies the symbolic data set name to be used as the file 
control table entry for a specific data set. This data set 
name can consist of from one to seven characters in CICS/DOS/VS 
and from one to eight characters in CICS/OS/VS. Because this 
data set name is used when generating the operating system 
control block (DCB, DTP and ACB), it must be the same as the 
| VSE file name or the OS/VS DDNAME used in the job control 

statement defining the data set. For VSAM ICIP KSDS files the 
DDNAME of the cluster need not be specified. 

If VSAM alternate index support is used to access a base 
cluster via an alternate index path, the data set name must be 
the same as the name of the alternate index path. This is 
| specified on the VSE file name or on the OS/VS DDNAME used in 

the job control statement defining the path. No entry is 
reguired in the file control table for the alternate index that 
is used to access the base data set. The link between the 
alternate index and the base data set is established when the 
path is defined using Access Method Services. 

Further information on the CICS/VS file control table and VSAM 
| definition of alternate indexes and paths can be found in 

| Figure 3.2—7 at the end of the section on the file control 

| table• 

Note: The data set name must not start with characters «DFH« 
because this becomes an externally specified name, and CICS/VS 
reserves the right to use any character string beginning with 
"DFH«. Therefore use of «DFH« may cause compatibility problems 
for the user. In addition, using "FCT" for a data set name 
prefix can cause assembly errors. 

For a DL/I data base, the DATASET operand must specify the same 
data base name as that specified In the NAME operand when 
generating the DBD. 


| ACCMETH= {BDAM | ISAM | DL/I | (VSAM[ , {KSDS |ESDS |BBDS} ][ ,ADR | KEY ])} 

specifies the method of organization for a specific data set. 

BDAM 

Basic Direct Access Method. 

DL/I 

Data Language/I. A DFHFCT TYPE=SHRCTL macro must be 
specified for DL/I data bases generated with SBRVREQ=SHARB. 

Note : Any data set accessed by calls to DL/I ENTRY under 

| VSE should have ACCMETH=VSAM, and not ACCMETH=DL/I• 


ISAM 

Indexed Sequential Access Method. 

VSAM 

Virtual Storage Access Method. 

KSD S 

key sequence data set. KSDS is the default when 
ACCMETH=VSAM. 
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ESDS 

entry sequence data set. 

RBDS 

relative record data set. 

ADR 

addressed update ACB option, only for KSDS files with 
the SHR0PT4 attribute. 

KEY 

keyed update ACB option, only for KSDS files with the 
SHR0PT4 attribute. 

Note: 

The value ADR or KEY must only be specified when the 
KSDS file is known to have the SHR0PT4 attribute. Its 
presence in any other situation will not be diagnosed 
during FCT assembly and may cause unexpected and 
unnecessary reduction in function during transaction 
processing. 


| SERVREQ=(request[,reguest],...) 

defines the types of service request that can be processed 
against the data set. The parameters that can be included are 
as follows: 

BROWSE 

| records may be sequentially retrieved from the data set. 

For CICS/DOS/VS, DFHFCT TYPE=LOGICMOD must be specified in 
order to use BROWSE for an ISAM file. 

DELETE 

records can be deleted from this data set. DELETE implies 
that UPDATE was specified. This is applicable to VSAM KSDS 
| (key sequence) and RRDS (relative record) data sets only. 

| Note that a generic delete cannot be used to delete records 

| from a protected data set. 


GET 

records on this data set can be read. 


INDACC 

data set is used as a cross—index. If INDACC is specified, 
the DFHFCT TYPE=INDACC macro instruction must be generated 
immediately following this DATASET definition. 


KEY 

| records are to be retrieved from or added to a keyed DAM 

j data set. This parameter can be specified only if 

ACCMETH=BDAM• 

NEWREC 

records can be added to the data set. NEWREC implies that 
PUT was also specified. NEWREC must be specified for OS/VS 
ISAM data sets with variable—length records if updating 
with a change in length is to be performed. 
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NOEXCTL 

records are not to be placed under exclusive control when a 
read for update is requested. Unless this parameter is 
specified, a read—for—update will cause the record to be 
placed under exclusive control (within the CICS/VS 
partition/region). NOEXCTL cannot be specified if 
ACCMBTH=VSAM or LOG=YBS are specified. Users of OS/VS with 
BDAM can specify LOG=YES and SERVREQ=NOEXCTL. 


PUT 

records can be written on this data set. This option need 
never be specified; the NEWREC or UPDATE options should be 
used. 


REUSE 

indicates that this data set is reusable. Recovery/restart 
support is not available for reusable data sets. This 
option is only applicable when ACCMETH=VSAM is specified 
and when the data set has been defined to Access Method 
Services as reusable. See also Note 5, below. 

SEGMENT 

records are segmented. If SEGMENT is specified, the DFHFCT 
TYPE=SEGHEAD, DFHFCT TYPE=SEGDEF, DFHFCT TYPE=SEGSET, and 
DFHFCT TYPE=SBGLAST macro instructions must be generated 
immediately following this DATASET definition. 

SHARE 

indicates that this data set is to share resources. This 
parameter can only be specified when ACCMETH=VSAM. This 
service cannot be requested for a path, for multiple user- 
catalogs, or for the base data set of an alternate index 
structure in which there is an upgrade set. If this option 
is specified, a DFHFCT TYPE=SBRCTL macro will be generated. 
The system programmer can either use this CICS/VS—provided 
macro, or can generate one explicitly. 

For VSE, an error code of X , 5C I may be returned on opening 
the file. This error, indicated by messages DFH1514 and 
42281 (VSE), should be ignored. 

UPDATE 

records can be updated on this data set. If UPDATE is 
specified, both GET and PUT are implied and need not be 
specified. An update on a generic key for a protected data 
set (LOG=YES) will result in an invalid request condition. 

Notes ; 

1. If any output service request option is to be added 
dynamically through the CSMT program facility, at least one 
output option (for example, SERVREQ=PUT) must be specified 
at assembly time. Similarly, for input options to be added 
with CSMT, at least one input option must have been 
specified in SERVREQ at assembly time. 

2. Only GET, PUT, and UPDATE are valid for VSAM ICIP data 
sets. 

3. To support the dynamic transaction backout facility, the 
reverse function for each operation specified in the 
SERVREQ operand must be generated. For example, 

SERVREQ=DELETE must be specified as well as SERVREQ=NEWREC. 
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4. INDACC and SEGMENT cannot both be coded for the same data 
set. A data set used as a cross—index data set cannot be 
defined as blocked BDAM. 

5. When a VSAB data set is in LOAD mode (that is, when it has 
been defined as reusable or when the first record is 
written to a new data set) the following restrictions 
apply: 


— STRN0=1 must be specified 

— neither VSAB ICIP nor VSAB shared resources can be used 

— the data set must be closed and reopened before any 
further processing can take place 

To avoid these restrictions, at least one record must oe 
loaded into the data set by means of an offline batch 
program. 


BLKKEYL=1ength 

specifies a decimal value from 1 through 255, which represents 
the physical key length for a direct access record. This 
operand must be specified for ISAB data sets and DAB data sets 
with physical keys. If a DAB data set contains blocked 
records, and deblocking is to be performed by using a logical 
key (that is, a key embedded within each logical record), the 
logical key length is specified by using the KEYLEN operand. 

The physical key cannot exceed 225 bytes. 

If necessary, CICS/VS can place a record under exclusive 
control by building an EBQ argument by concatenating the data 
set name, the block reference (if DAB) , and the physical key. 

An ENQ will then be issued using a maximum of 255 bytes of this 
argument. If the argument exceeds 255 bytes in length, the EHQ 
will result in placing a range of keys under exclusive control. 
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| BLKSIZE=(iength[,length]) 

specifies the length (in bytes) of the block. If blocks are 
variable-length or undefined, for CICS/OS/VS, the length 
specified should be the maximum block length. For undefined 
blocks, with CICS/DOS/VS, the length must be the maximum user- 
defined blocksize plus 8. If the NBNRBC or BROWSE operands are 
used for DAB fixed—length data sets with keys, BLKSIZE must be 
(LBECL + BLKKEXL) for unblocked records or (LBECL * BLOCKING 
FACTOR + BLKKEXL) for blocked records. This operand is not 
required for VSAB. 

For CICS/DOS/VS, this operand can contain only one value 
(parameter). This value can not be enclosed within 
parentheses. 

If the CICS/OS/VS user wishes to have a BLKSIZE value generated 
in the DCB, he must specify that value in the second parameter 
of the operand; for example, BLKSIZE=(250,250), where the first 
”250" relates to the FCT and the second "250" relates to the 
DCB. If the second parameter is not specified, the DCB is 
generated without a BLKSIZE value. The DCB value (second 
parameter) must always specify the true block size while the 
FCT value (first parameter) may, for DAN data sets, include the 
BLKKEXL value. The first BLKSIZE value specified must not be 
less than the actual blocksize of the data set. 


BUFND=number 

specifies, for VSAB only, the number of buffers to be used for 
data. The minimum specification is the number of strings plus 
one (see the STBNO operand). 

For VSAB ICIP files, BUFND must be omitted (when the value of 
STBNO will be used) or made equal to STRNO. (If BUFND is less 
than STBNO, it will be set to the value in STBNO. If BUFND is 
greater than STBNO, extra fixed buffers and RPLs will be 
obtained and not used.) 


BUFNI=number 

specifies, for VSAB only, the number of buffers to be used for 
the index. For non—ICIP files, the minimum specification is 
the number of strings specified in the STBNO operand. 

BUFNI is required for VSAB KSDS files when B0DE=ICIP is 
specified. The number specified for BUFNI need bear no special 
relation to the number of strings indicated in STBNO, but must 
be at least one. BUFNI specifies the number of index buffers 
and index RPLs which are obtained when the file is opened. 


Notes: 


1. If BUFSP exceeds the requirements of BUFND and BUFNI, the number of 
buffers will be increased proportionally. 

2. All I/O buffers are acquired by OPEN for VSAB, and are controlled 
exclusively by VSAB during execution. CICS/VS file management 
causes VSAB to move all data into a file work area. Under some 
circumstances, CICS/VS will use LOCATE mode and will move the data 
itself into the appropriate area. If the user request is for 
LOCATE mode, the address of the data in the VSAB buffer will be 
returned in a VSAB work area. 
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BUFSP=number 

specifies, for VSAM only, the size in bytes of the area to be 
reserved for buffers for this data set within the CICS/VS 
region/partition. If less than the minimum is specified, VSAM 
(under OS/VS) will not open the data set. Under VSE, VSAM will 
override the BUFSP value with the value from the catalog and 
will open the data set. If this operand is not specified, VSAM 
OPEN will obtain a minimum size area, which will be the minimum 
storage required to process the data set with its specified 
processing options. This operand is not required for VSAM ICIP 
files and will be ignored if specified. 

In VSE, if the BUFSP value specified is greater than the 
minimum value required but less than the values required for 
BUFND and BUFNI, the size of the buffer space allocated will be 
changed to conform with the requirements of BUFND and BUFNI. 

In OS/VS, the number of buffers will be proportionally reduced 
to comply with the requirements of BUFSP. 

For further details on defining VSAM buffer space, refer to the 
ACB AM=VSAM macro in OS/VS System Programmers Guide or in 
VSE/Advanced Functions Macro Reference . 

Note: Extreme care must be taken in choosing the value 
specified in the BUFSP operand. While the file is open, this 
storage space is controlled exclusively by VSAM; it will be 
used only for buffers and only for the specified file unless 
the VSAM shared resources facility is used (see «VSAM Shared 
Resources Control” later in this section). Even with quite low 
activity on the file, this buffer space could remain in main 
storage for a significant percentage of the time that the file 
is open. Thus it could have a considerable impact on the 
working set. 


FILSTAT={ENABLED|DISABLED},{OPENED)CLOSED} ) 

specifies the initial status of the data set. The status may 
be changed by using the master terminal function. The default 
is FILSTAT=(ENABLED,OPENED) . 

CLOSED 

indicates that the data set is to remain closed until a 
request is made to open it either through the master 
terminal function, or through a DFHOC macro instruction in 
an application program. 

DISABLED 

indicates that any request against this data set will cause 
the application program to be abnormally terminated. 

ENABLED 

indicates that normal processing is to be allowed against 
this data set. 

OPENED 

indicates that the data set is to be opened by system 
initialization. 
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INDA fiEA=sym Joolic—name 

specifies the unique symbolic name, which is used by the DPHFCT 
macro to generate a storage area automatically (within the file 
control table) that will contain all or part of the cylinder 
index. This operand is only required if ACCMETH=1SAM and the 
cylinder index is to be processed in dynamic storage. 


INDSIZE=length 

specifies the length (in bytes) of the cylinder index area 
specified in the INDAREA operand. 

For CICS/DOS/VS, the minimum number of bytes can be calculated 
as: 


(m+3)*(keylength+6) 

where "i» is the number of entries to be read into main storage 
at one time, 3 is the number of dummy entries, and 6 is an 
abbreviated pointer to the cylinder. If "i* is set to the 
number of prime data cylinders + 1, all of the cylinder index 
is read into main storage at one time. 

For CICS/OS/VS, the minimum number of bytes can be calculated 
as: 


i*e* (key length + 10) 

where "i" is the number of tracks in the high-level index, and 
"e H is the number of entries per track. 

This operand is applicable only if ACCMETH=ISAM and the INDAREA 
operand is specified. 


IOSIZB=length 

specifies the number of bytes in the main storage area used 
when adding records to an ISAM data set. This operand must 
only be used when ACCMETH=ISAM and SERVEEQ=NBWREC are also 
specified. In CICS/DOS/VS, this operand causes a static work 
area to be generated as part of the FCT entry for the data set 
being defined. In CICS/OS/VS, the IOWORK operand must also be 
used to supply a symbolic name to be associated with the work 
area. 

Note : Under CICS/DOS/VS with multiple ISAM files, if the 

IOSIZE operand is specified for any one ISAM file with the 
SERVREQ=NBWREC option, in order to avoid the need for two ISAM 
logic modules (one with and one without the COBDATA=YES 
option), all other ISAM files must have SERVfiEQ=NEWREC and an 
adequate IOSIZE specified. 


JID=(NO|SYSTEM|nn} 


specifies whether automatic journal activity is to take place 
for this FCT entry and identifies the file to be used to record 
the journaled data. The operations that will cause data 
records to be journaled are specified in the JREQ parameter. 

The default is JID=N0. 


indicates that journal activity will not occur on this FCT 
entry. 
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SYSTEM 

indicates that journaling is to be performed on the system 
log • 

nn 

is the journal identification and can contain a value in 
the range 2 through 99. 

Note : Automatic journaling may be specified if the user wishes 
to record data set activity for subsequent processing by the 
user (for example,. user-written data set I/O recovery)• It 
must not be confused with automatic logging (specified with 
LOG=YES), which is reguired if CICS/VS is to perform data set 
backout to remove in-flight task activity during emergency 
restart or dynamic transaction backout. 


JREQ={ALL| (request[ ^request,...])} 

specifies which data base operations will be automatically 
journaled and whether the journaling operation is to be 
synchronous or asynchronous with data set activity. 

When a synchronous journal operation is executed for a READ 
request, control is not returned to the program that issued the 
file control request until the data read is written on the 
journal data set. When a synchronous journal operation is 
executed for a WRITE request, the output operation to the data 
set is not initiated until the data is written on the journal 
data set. When an asynchronous journal operation is executed 
for a READ reguest, control can be returned as soon as the data 
read is moved to the journal I/O buffer. 

When an asynchronous journal operation is executed for a WRITE 
request, the output operation to the data set can be initiated 
as soon as the data is moved to the journal I/O buffer. 
Synchronization defaults provide asynchronous operation for 
reads and synchronous operation for writes. If this operand is 
omitted and JID is specified, JREQ will default to 
JREQ= (WtJ,WN) . 

ALL 

Journal all data set activity with READ asynchronous and 
WRITE synchronous. 

ASY 

Asynchronous journal operation for WRITE operations 
RO 

Journal READ ONLY operations 
RO 

Journal READ UPDATE operations 

SYN 

Synchronous journal operation for READ operations 

WN 

Journal WRITE NEW operations 
WU 

Journal WRITE UPDATE operations 
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KBYLEN=length 

specifies the length of the logical key for the deblocking of 
DAM data sets. This operand is also applicable for remote 
files. If omitted for this type of file, the length option 
must be specified in the application program that refers to 
this file. 

The logical key for DAM data sets is embedded and located 
through the use of the RKP operand. The length of the recorded 
(physical) key is specified in the BLKKEYL operand, and can be 
different from the value specified for KEYLEN. 

This operand must always be specified when logical keys are 
used in blocked DAM data sets, and must not be specified for 
VSAM data sets. 


LOG={NO|YES} 

specifies whether automatic logging to the system log is to be 
performed. The logging function, as opposed to automatic 
journaling, records all data necessary to backout data base 
updates, additions, and deletions in case of an emergency 
restart or dynamic transaction backout. The data recorded is 
the ,t before M copy of the record for update—in—place operations, 
unique record ID for additions, and a copy of the record for 
deletions. The default is LOG=NO. 

NO 

indicates that automatic logging is not to be performed. 

YES 

indicates that automatic logging is to be performed. 

Note: If LOG-YES is specified, when a request is made to 

alter the contents of this data set, the record being 
updated, added, or deleted will be enqueued upon, using the 
record identification. This enqueue will be maintained 
until the task terminates or issues a DFHSP macro to signal 
the end of a logical unit of work. This is necessary to 
ensure the integrity of the altered data. Because the 
enqueues are thus maintained for a longer period of time, 
the potential for an enqueue lockout exists if an 
application program that accesses this data set performs 
what is effectively more than one logical unit of work 
against it, without defining each separate logical unit of 
work to CICS/VS by issuing sync point request. Also, long- 
running tasks could tie up storage resources. 

If an alternate index structure is being used and recovery 
is required, all updates to the base data set must either 
be made via the base data set or via a single path. It is 
strongly recommended that all updates are made directly on 
the base data set and that paths are used for enquiry only. 

If an attempt is made to perform a generic DELETE or 
generic UPDATE operation when LOG=YES is specified, an 
invalid request will result. 
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| LRECL= (length[ ,length ]) 

specifies the maximum length (in bytes) of the logical record. 
The value specified is also the length of records in a fixed 
length remote file. If this operand is not specified, the 
length can be specified in the application program. Refer to 
the DPHFCT TYPE=REMOTE macro for further information on remote 
| files. For VSE ISAM data sets with variable—length records 

within fixed—length blocks, this number has no relation to the 
actual length of any logical record. However, the number 
specified, multiplied by the NRECDS parameter, must equal the 
actual block size on the data set. This operand must always be 
specified for ISAM and DAM data sets, but is not required for 
VSAM data sets. 

For CICS/DOS/VS, this operand must contain only one value 
(parameter). This value cannot be enclosed within parentheses. 

If the CICS/OS/VS user wishes to have an LRECL value generated 
in the DCB, that value must be specified in the second 
parameter of the operand; for example, LRECL= (50,50), where the 
first ,l 50 lf relates to the FCT and the second "SO 11 applies to 
the DCB. If the second parameter is not specified, the DCB is 
generated without a LRECL value. If the data set is BDAM 
organized, the second parameter must never be specified. 


OPEN= {INITIAL I DEFERRED} 

specifies the initial status of the data set and can only be 
specified if the FILSTAT operand is not specified. The default 
is OPEN=INITIAL. 

INITIAL 

causes the data set to ne opened by system initialization. 
DEFERRED 

causes the data set to remain closed until the user 
indicates that he wishes to open it by using the master 
terminal open/close service function or by a DFHOC macro 
instruction in an application program. 

Note : If the user specifies OPEN=DEFERRED for DL/I under 

I VSE data bases, the data set will not be opened until the 

| STRT system call is issued. 


PASSWD=password 

specifies a one— to eight—character password, which VSAM will 
use to verify the user access to the data set. If less than 
eight characters are specified, the password will be padded to 
the right with blanks. If omitted and the data set is password 
protected, the console operator may be asked to provide the 
appropriate password. This operand is only applicable for 
ACCMETH=VSAM• 


RECFORM = ([ {UNDEFINED! VARIABLE! FIXED} ][ {,BLOCKED |UNBLOCKED} }[ ,DCB format] 
r -DOSISAM]) 

describes the format of records on the data set. The default 
is UNDEFINED for ISAM and BDAM data sets and (VARIABLE,BLOCKED) 
for VSAM data sets. 

BLOCKED 

records are blocked. 
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DCB format 

specifies the record format in the DCB; for example, 
RECFORM= (FIXED,BLOCKED,FBS) • 

DOSISAM 

indicates a VSE VSAM file that is generated directly from 
an originally unblocked ISAM file. If this option is 
specified, the KEYLEN operand must also be specified. 

FIXED 

records are fixed length. 

UNBLOCKED 

records are not blocked. 

UNDEFINED 

records are of undefined length. 

VARIABLE 

records are variable length. 

Notes: 


1 . 


I 

I 


For CICS/OS/VS ISAM data sets with the BROWSE option 
specified, a DCB RECFM parameter of VB or FB is always 
generated. CICS/OS/VS does not support unblocked ISAM data 
sets that have the BROWSE option specified. 


2. BLKSIZE must include an additional eight bytes for the 

count field when NEWREC is specified for undefined records 
in CICS/DOS/VS. 


3. BLOCKED or UNBLOCKED must be specified for all ISAM and 
BDAM data sets of FIXED or VARIABLE format. 


4. ISAM compatibility is indicated by specifying the UNBLOCKED 
characteristic for a VSAM data set. This means that the 
record will be returned in a FIOA for all non—segmented, 
read-only requests. 

5. The DC3 format is not applicable to VSAM data sets. 


6. RECFORM=DOSISAM must be specified if an unblocked ISAM file 
is converted to a VSAM file and the original ISAM programs 
are to be used to access the file. This option must not be 
specified if the application program is written in a 
command—level language. 


7. RECFORM- (VARIABLE,BLOCKED) must be specified for a VSAM 
ESDS data set that uses journaling, to ensure that 
transaction backout and dynamic transaction backout 
function correctly. 


RELTYPE={BLK|DEC|HEX} 

specifies that relative addressing is being used in the block 
reference portion of the record identification field of DAM 
data sets only. If the RELTIPE operand is omitted, absolute 
addressing is assumed (that is, MB3CCHHR). The EXTENT 
parameter must also be specified if RELTYPE is used in 
CICS/DOS/VS. 

BLK 

indicates that relative block addressing is being used. 
BLK applies to CICS/OS/VS only. 
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DEC 


indicates that the zoned decimal format is being used. 


BEX 

indicates that the hexadecimal relative track and record 
format is being used. 


BKP=number 

specifies the starting position of the key field in the record 
relative to the beginning of the record (position zero for DAB 
and ISAM data sets excep^ ons-it-inn nna f or VSE ISAM data sets) . 
With variable—length records, this operand must include the 
four—byte Lipp field at the beginning of each logical record. 
This operand must always be specified for data sets that have 
keys within each logical record, or when browsing. 




Notes : 

1. SEBVRBQ=BROW SE requires embedded keys in the data field in 
| VSE ISAM, therefore the RKP parameter is required. 

| 2. In VSE ISAM, if records are unblocked, the following MNOTE 

will be generated by ISAM in the DTFIS: "0, KEYLOC 

INVALID, PARAMETER IGNORED". 


| RSL-{0|number} 

| indicates the security level, in the range 1 to 24, to be 

| associated with this resource (the data set). The default is 

| RSL=0. 


SRCHM-{YES Inumber} 

provides a multiple track search for keyed records. This 
operand is applicable only to DAM keyed data sets. 

YES 

indicates that multiple track search will be used. 
SRCBM-YBS must be specified if fixed—length records with 
keys are to be added to the file. This option applies to 
CICS/DOS/VS only. 

number 

indicates the number of tracks or blocks to be searched. 

| The default is 0. This option applies to CICS/OS/VS only. 
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STRNO=Q|number} 

specifies the number of concurrent requests that can be 
processed against the data set. When the number of requests 
reaches this limit, CICS/VS will automatically queue any 
additional requests until one of the active requests 
terminates. The default is STRH0=1. 

This operand is applicable only if ACCMETH=VSAM is specified. 
For VSAM ICIP files, the value specified in BUFND is used (if 
available) when a value for STRNO is not specified; otherwise a 
default value of 1 is assumed. 

CICS/VS relies upon the STRHO value that is specified in the 
file control table. For CICS/OS/VS the STRNO value must not be 
overridden by the JCL AMP parameter. 

CICS/VS will accumulate statistics that will aid the system 
programmer in determining the optimum STRHO value for this 
particular configuration. Guidance on how to chose the optimum 
value for STRHO can be found in the appropriate CICS/VS System 
Programmer*s Guide (DOS/VS or OS/VS). 

Note s For ICIP files, STRHO specifies the number of data 
buffers and data RPLs obtained when the data set is opened. 


VERIFY=YES 

indicates that the user wants to check the parity of disk 
records after they are written. If this operand is omitted, 
records are not verified after a write request. This operand 
is not valid when ACCMETH=VSAM is specified. 


CICS/POS/VS Only 


CYLOFL=number 

specifies the number of tracks per cylinder that are reserved 
for cylinder overflow records. Note that CYLOFL=0 is an 
invalid specification. If no cylinder overflow space is to be 
reserved, the operand should be omitted completely. This 
operand is only required if ACCMETH=ISAM. 



DBVICB= (2314 #2314) | (n[,m]) 

specifies the type of device to be used for DAM and ISAM data 
sets. The applicable devices are 2314, 3330, 3340, and 3350 
(DAM only). The default is DEVICE=(2314,2314). 

n 

for DAM, specifies the device type on which the data set 
resides. 

for ISAM, specifies the device type on which the prime data 
area (and overflow area if present) resides. 

m 

for ISAM only, specifies the device type containing the 
high-level index. 
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BXTENT=number 

represents the maximum number of extents that are specified for 
a data set. This operand is required if ACCMETH=ISAM. 

EXTENT=2 represents a minimum value (one for prime data area 
and one for cylinder index). If ACCMETH=BDAM, the presence of 
the EXTENT operand indicates that relative addressing (as 
opposed to actual addressing) is being used and the RELTYPE 
operand must also be used. 


INDSKIP^YES 

indicates that the index skip feature is to be used if index 
entries reside in main storage. This operand is only 
applicable if ACCMETH^ISAM and the INDAREA operand are 
specified. 


MSTIND=YBS 

indicates that a master index exists for the ISAM data set. 
This operand is only applicable if ACCMETH=ISAM and must be 
specified only if a master index exists for the data set. 


NRECDS=number 

| specifies the number of logical records in a block (the 

blocking factor). This operand is only applicable if 
| ACCMETH=ISAM, and if the records are blocked. For YSE ISAM 

data sets with variable—length records within fixed—length 
blocks, this number has no relation to the actual number of 
records within the block. However, the number specified 
multiplied by the LRECL parameter must equal the actual block 
size on the data set. 

Note ; NRECDS=1, LRBCL=blocksize, is not allowed. The most 
advantageous specification is NRECDS=n, LRECL= (blocksize/n) 
where "n" is some decimal value greater than 1. 


CICS/OS/VS only 


BASB=name 

specifies the name of the base data set of an AIX (alternate 
index) structure. This parameter can only be specified for an 
AIX path, and only if the path and its base are to participate 
in VSAM data set sharing under CICS/OS/VS. The file control 
table must contain an entry for the base data set if this 
operand is specified. 

I Figure 3.2—7 at the and of the description of this table 

| provides an example of how to code the CICS/VS and VSAM entries 

| for a VSAM alternate index structure. 

Data set sharing gives improved data set integrity. The user 
should note, however, that when data set sharing is used for an 
AIX structure, all the control blocks for access to the base 
are created when the first member of the structure is opened, 
whether this is a base data set or a path. Thus, as soon as 
any member of the structure is opened, the number of VSAM 
strings allocated to the base is equal to the sum of the number 
of the CICS/VS strings (indicated in the STRNd operand) 
specified on the FCT entries. This applies for the base data 
set and for all the paths defined over it that have BASE=aame 
specified. 
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DATA=name 


is required when a VSAM KSDS cluster is to be accessed using 
VSAM ICIP. Name is the ddname of a DD statement, which defines 
the data component of the cluster. This operand must be 
specified when KSDS files are accessed using ICIP. Refer to 
the examples of mixed mode files at the end of the file control 
section. 


INDEX= (name[ ,number[ , f INIT IDYNI ]]) 

must be specified if the data set is a VSAM ICIP KSDS cluster 
and is to be accessed using ICIP oy means of Keys. See the 
examples of mixed mode files given at the end of the section on 
the file control table. 

DYN 

indicates that the in—memory index will be created 
dynamically; that is, an index record required in memory 
will only be put in memory when it is referenced in 
response to a GET request for that file. 

INIT 

indicates that all levels of index that are to be retained 
in memory will be read into memory when the file is opened. 
This is the default if neither INIT nor DYN is specified. 


name 

is the ddname of a DD statement, which specifies the index 
component of the cluster. 

number 

indicates the number of levels of VSAM index to be excluded 
when building an in—memory index. The default is one. 


IOWORK=symbolic—name 

specifies the symbolic name of a main storage work area to be 
used by the access method when adding records to ISAM data 
sets. If the data set contains variable—length records, this 
operand must be specified. This operand is only applicable if 
ACCMETH=ISAM • 

It is permissible for the same symbolic name to be specified in 
more than one data set definition, thus causing an area to be 
shared. CICS/VS prevents the shared area from being used 
concurrently by more than one transaction. 

A static work area is generated within the PCT for each unique 
symbolic name encountered during FCT generation. The size of 
each area is equal to the largest IOSIZE specified for each 
symbolic name. 


MODE= ( {VSAM I ICIP}[ , MIXED]) 

indicates whether the data set can be accessed by normal VSAM 
processing, by VSAM improved control interval processing 
(ICIP), or by either method. This operand is only available 
when ACCMETH=VSAM is specified. The default is VSAM. 

The VSAM improved control interval processing feature (ICIP), 
which is only available in CICS/OS/VS when the SRBSVC operand 
is specified in DFHSG TYPE=INITIAL, provides a fast path that 
provides improved performance for accessing control intervals 
for both KSDS and BSDS files. 
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ISAM 


indicates that the data set is to be opened for normal VSAM 
processing. 

ICIP 

indicates that the data set is to be opened for VSAM ICIP 
processing. The data format for ICIP files is identical to 
that of normal VSAM ESDS and KSDS data sets, and the data 
set can subsequently be processed using normal VSAM. When 
MODE=ICIP is specified, only the GET, PUT and UPDATE 
options of the SBRVREQ operand may be specified. 

MIXED 

indicates that the data set can be accessed by either 
normal VSAM or by VSAM ICIP, using the same data set name. 
The DFHOC macro (with the MODE option specified) may be 
used to close and reopen the file. Refer to Chapter 7.2 
for further details on DPHOC. If MODE-MIXED is specified, 
a DFHFCT TYPE=ALTERNATE macro instruction must be 
specified. Users should study the examples on ICIP and 
mixed mode files, which are given at the end of the file 
control section. 

The following considerations apply to data sets that are 

accessed by VSAM ICIP; 

• The control interval size must equal the physical record 
size. 

• Mew records can not be added to a file while it is being 
accessed using VSAM ICIP. 

• Browsing and segmenting are not supported. 

• Sharing of resources is not supported. 

• Indirect access and alternate indexes are not supported. 

• Relative record files are not supported. 

• Spanned records are not supported. 

• Buffers for use with VSAM ICIP will be in fixed pages to 
avoid the overhead of VSAM fixing pages for each access. 

• Data sets that have either replicated index records or 
sequence set records adjacent to control areas are not 
supported. 


STRNOG=number 

indicates the number of strings to be reserved for GET only 
processing for VSAM files. STRNOG specifies a decimal integer 
that is less than the STRNO value specified and greater than or 
equal to 0. The default value is 20% of the STRNO value 
specified. 
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CROSS—INDEX DATA SET RECORD — DFHFCT TYPE=INDACC 


The record on a cross—index data set that points to the next data set to 
be read is described in the DFHFCT TYPE=INDACC macro instruction. This 
macro instruction may also contain information regarding duplicate 
records that can be referenced by this index record, including a pointer 
to a duplicate data set that contains additional identifying 
information. 

If this macro instruction is used, the SBRVREQ operand of the DFHFCT 
TYPE=DATASET macro instruction must include GET and INDACC. For further 
information on indirect accessing, refer to the section on File Control 
in the CICS/VS Application Programmer l s Reference Manual (Macro Level) . 


r-1- - —• 



JDFHFCT 

1 

TYPE=I»DACC 



1 

1 

,IALKFL=length 



1 

1 

,IARLKP=number 



1 

1 

,OBJDSID=name 



1 

1 

[ . ARGTYP= fKEY1RBA}] 



1 

1 

[ ,DUPDSID=name] 



1 

1 

[ ,IADADHI=(KEY|RBLREC} ] 



1 

1 

[,IADIII=character] 



1 

1 

T,SRCHTYP= fFKEQ1FKGBIGKSO1GKGE1 1 



I-1-L 


TYPE=INDACC 

specifies an indirect access data set. 


| IALKFL=length 

specifies the length (in oytes) of the record identification 
field that is to be used to access the object data set. 


IARLKP=number 

specifies the relative location within the cross—index data set 
record of the record identification field that is to be used to 
access the object data set. The displacement is relative to 
the beginning of the record (position zero). 


OBJDSID=name 

specifies the name of the object data set referenced by the 
cross—index data set record. This name can consist of from one 
to seven characters in CICS/DOS/VS and from one to eight 
characters in CICS/OS/VS. 


ARGTYP= {KEY|RBA} 

specifies information concerning the argument contained in the 
cross—index record. The default is ARGTYP=KEY. 

KEY 

indicates that the argument is a key. 

RBA 

indicates that the argument is a relative byte address. 

The ARGTYP operand is applicable only when the object data set 
indicated by OBJDSID is a VSAM data set. 
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DUPDSID=name 

specifies the identification for the duplicate data set 
associated with the cross—index data set. This identification 
can contain up to seven characters for CICS/DOS/VS and up to 
eight characters for CICS/0S/7S. This operand can be omitted 
if a duplicate data set does not exist. 


IADADMI={KEY|RELREC} 

specifies the argument type for the deblocking of a record from 
a blocked BDAM data set. 

This operand can only be used if the data set (file) to which 
this index data set points is the primary (target) data set. 

If this operand is omitted, and if the data set to which this 
index data set points is a blocked BDAH data set, the entire 
block is returned to the user in the file control area. 

KEY 

indicates that the deblocking technigue is key. 

RELREC 

indicates that the deblocking technique is relative record. 


IADIII=character 

specifies a one—byte user-assigned hexadecimal character, which 
signifies that the data in the record identification field 
refers to a duplicate data set rather t^ian the normal object 
data set. This code must be contained in the first position of 
the record identification field and must be different from any 
other data that would normally appear in this position. This 
operand must always be specified if a duplicate data set name 
is specified (in the DUPDSID operand). 


SRCHTYP=f FKEQ f FKGE I GKBQ t GKGE} 

describes the key and how it is to be used when retrieving the 
record from the object data set. This operand is only 
applicable when the object data set indicated by OBJDSID is a 
VSAM data set and when ARGTYP=KEY. The default is 
SRCHTYP=FKEQ. 

FKEQ 

specifies that the key contained at the RDIDADR address is 
a full key and that a record with this exact key will 
satisfy the search. 


FKGE 

specifies that the search argument is a full key and that 
the first data record with a key equal to or greater than 
the argument will satisfy the search. 

GKEQ 

specifies that the search argument is a generic (partial) 
key, the length of which is specified in the first byte of 
the record identification field. The search is satisfied 
if a record is found, the key of which is equal to the 
argument (compared only on the number of bytes specified). 


GKGE 

specifies that the search argument is a generic key and 
that the first data record with a key equal to or greater 
than the generic argument will satisfy the search. 
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SUPERSET ISAM LOGIC MODULE — DFHPCT TYPB=LOGICMOD 
(CICS/DOS/VS ONLY) 


A superset ISAM logic module can be generated in-line within the file 
control table under CICS/DOS/VS by including a DFHFCT TYPE=LOGICMOD 
macro as the last statement in the file control table. 

Any further ISAM logic modules reguired in order to resolve V—cons in 
the file control table are indicated by MNOTEs that are produced when 
DFHFCT is assembled. One file control table may need up to four 
DFHlSHODs, depending on whether support for rotational position sensing 
(EPS) and the ••prime data in main storage" option of ISAM record 
addition (the CORDATA=YES option) is required, giving a total of four 
combinations of functional support. In general, these additional 
modules must be assembled separately and link-edited into the file 
control table. 

In many cases, the user may only need one ISAM logic module; however, 
DFHFCT always makes provision for both RPS and non—EPS versions. If BPS 
is not used, the 7—con (s) for the BPS module (s) can be left unresolved 
at the link—edit stage. Where BPS is used exclusively, the V-con(s) for 
the non-BPS module(s) can be left unresolved, but only at the risk of 
errors if the conditions at execution are unsuitable for the use of BPS. 

The requirement for ISAM logic modules both with and without 
COBDATA-YES is only avoided if all or none of the ISAM files specify 
both SEBVREQ=NBWREC and the IOSIZE operand in DFHFCT TYPB=DATASBT. 

For further details on preparing logic modules, see the CICS/VS System 
Programmers Guide fDOS/YSl . 

•- 1 - 1 - 

| |DFHFCT | TYPE=LOGICMOD 

| | | [,RPS=SVA] 

i_i-1- 


I 

I 


TYPE=LOGICMOD 

indicates that an ISAM logic module is to be created. 


BPS=SVA 


I 
I 

When this operand is specified, enough GETVIS space must be 
allocated for a DTF work area for each ISAM data set. If 
insufficient space is allocated, those ISAM data sets for which 
a DTF extension could not be acquired will be disabled when the 
first I/O request is issued. At that time the requesting 
transaction will be abnormally terminated with code AFCB. 

The user is responsible for ensuring that the FCT is link- 
edited with suitable ISAM logic modules for the conditions of 
execution. The diagnostic messages at the end of the FCT 
provide guidance. 


indicates that the logic module to be generated is to use 
rotational position sensing (BPS). The use of BPS will depend 
on the device and the availability of GETVIS space, which can 
be allocated through the SIZE parameter of the // EXEC job 
control statement. For further information see VSE/Advanced 
Functions Macro Reference. 
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REMOTE FILES 


DFHFCT TYPE=REMOTB 


The DFHFCT TYPE=REMOTE macro defines the files that reside in a remote 
| system or region when the CICS/VS intercommunication facilities are 
being used. 


| IDFHFCT | TYPE=REMOTE 

| | | ,DATASET=name 

| | | ,SYSIDNT=name 

| | | [,KEYLBN=key-length ] 

j | | [,LRECL=record—length] 

| | | [,RMTNAME=name] 

II I I [ ,RSL= {=21 number} ] 

i —i_i- 


TYPE=REMOTE 

indicates that this FCT entry identifies a file that resides in 
| a remote system or region. 


DATASET=name 

| indicates a one— to seven— (VSE) or a one— to eight— (OS/VS) 

character name, which is referred to by the application 
programs in the same system as this file control table. 


I 

I 

I 

I 


SYSIDNT-name 

specifies the four-character alphanumeric name of the system or 
region in which the file is resident. The name given must be 
the same as that in the SYSIDNT operand in the DFHTCT 
TYPE=SYSTEM macro or in an explicit remote request in an 
application program. 


K E YLEN =key-le ngth 

indicates the default key length for a file control request 
that is sent to a remote system. 


LRECL=record—length 

indicates the default data length (in bytes) for a READ WRITE 
or REWRITE request that is sent to a remote system. 

Further information on the key and data length values to be 
specified for remote systems can be found under the KEYLEHGTH 
and LENGTH operands in the CICS/VS Application Programmer*s 
Reference Manual (Command Level) . 


RMTNAME—name 

| indicates a 1— to 7-character (VSE) or 1— to 8-character 

I (OS/VS) name by which the file is known to the system in which 

it resides. If this operand is omitted (the normal case), the 
name specified in the DATASET operand will be used. RMTNAME 
allows two files, with the same name but in different systems, 
to be referenced. 

| RSL= (01number) 

j indicates the security level, in the range 1 to 24, to be 

| associated with this resource. The default is RSL=0. 
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sbghented recobds 


The following macros are used to define segmented records to C1CS/VS 
file management. They are presented alphabetically in the following 
description but must be coded in the following sequence: 

1. DFHPCT TYPE=SEGHEAD 

2. DFHFCT TYPE=SEGDEF 

3. DFHFCT TYPB=SEGLAST 

Or, if there are no SEGDEF or SEGHEAD statements: 

1. DFHFCT TYPE=SEGSET 

2. DFHFCT TYPE=SEGLAST 


SBGHBNTS OF A SBGHENTED EECOBD - DFHFCT TYPB=SEGDEF 


Each segment of a segmented record is described by means of the DFHFCT 
TYPE=SBGDEF macro instruction. TYPB=SEGDEF must be generated for every 
segment in the record in the sequence in which it occurs within the 
record. The last segment defined must be followed by the TYPB=SEGLAST 
macro, which must precede the TYPE=SEGSET operands to generate 
SEGSET=ALL automatically as the first segment pattern in the file 
control table. A maximum of 99 segments can be defined per record. 

I-1---*- 

IDFHFCT | TYPE=SBGDBF 

| | ,SEGNAME=name 

| | ,SEGLENG=length 

| | [ ,SBGCHAR= ({FIXED|VABIABLE},{BYTE|DOUBLE|FULL|HALF}) ] 


TYPE=SBGDEF 

specifies segment definitions. 

SEGHAHE=name 

specifies the eight-character symbolic name (label) of the 
segment. This operand must always be specified. 


SBGLENG=length 

specifies the length (in bytes) of the segment; up to 255 bytes 
can be specified (the length of the largest segment allowed)• 

If the segment is variable length, this value represents the 
maximum length. This operand must always be specified. 


SBGCHAR= ( (FIXED I VARIABLE!, (BYTE|DOUBLE|FULL|HALF}) 

indicates the characteristics (format,alignment) of the 
segment. If one characteristic is to be specified, both must 
be specified. The default is SEGCHAR=(FIXED,BYTE). 

FIXED 

indicates that the segment is fixed—length. 
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VARIABLE 

indicates that the segment is of variable lengtn. The 
first byte of the segment indicates the length of the 
segment. 

BITE 

| indicates that the segment is byte—aligned. 

DOUBLE 

indicates that the segment is doubleword—aligned. 

FULL 

indicates that the segment is fullword-aligned. 

HALF 

indicates that the segment is halfword-aligned. 


HEADER OF SEGMENTED RECORD — DFHFCT TYPE=SEGHEAD 


If the records on a data set are segmented, the DFHFCT TYPE=SEGH£AD 
macro instruction defines the header portion (root or control segment) 
of a segmented record. TYPE=SEGHEAD is the first of four statements 
that must be coded to specify segmented records. 


| IDFHFCT | TIPE=SEGHEAD 

| | | ,SEGLBNG=length 

I | | ,INDDIS P =numb er 

| | | [,TSBGIND={BIT|DISPLACEMENT}] 

i-1_«_ 


TYPE=SEGHEAD 

specifies the header of a segmented record. 


SBGLENG=length 

specifies the length (in bytes) of the header portion (root 
segment) of the record. For VS AM variable length data sets, 
this length must include 4 bytes for an LLfield even though 
one does not exist on the data set. File management will 
create one after retrieving the physical record. This operand 
must always be specified. 


INDDISP=number 

provides the displacement of the segment indicator field 
relative to the beginning of the record (position zero). This 
does not include the length field for variable length VSAM data 
sets. This operand must always be specified. 


TSEGIND={BIT|DISPLACEMENT} 

specifies the type of segment indicator field that is contained 
in the root segment. The default is TSEGIND=BIT. 

BIT 

specifies that segments are indicated by bits in the 
segment indicator field. 
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DISPLACEMENT 

specifies that segments are indicated by displacements in 
the segment indicator field. 

It is the user , s responsibility to maintain the segment 
indicator field. 


LAST SEGMENT SET — DFHFCT TYPE=SEGLAST 


The end of the segment definitions and the end of the segment set 
definitions are indicated by the DFHFCT TYPE=SEGLAST macro instruction, 
which must be generated immediately following the last macro segment 
definition fPYPE=SEGDEF) and immediately following the last segment set 
(TYPE=SEGSET) for a data set. If no DFHFCT TYPE=SEGSET macro 
instructions have been coded, a DFHFCT TYPE=SEGLAST macro instruction 
(to indicate the end of the segment sets) must immediately follow the 
DFHFCT TYPE=SBGLAST used to indicate the end of the segment definitions. 

This macro instruction generates SEGSET=ALL, which includes all the 
segments in the record, as the first entry in the segment set portion of 
the file control table. 


r 

I 

L 


IDFHFCT | TYPE=SEGLAST 
.1-1- 


I 

j 


TYPE=SEGLAST 

indicates the end of the segment definitions. 


SEGMENT SETS — DFHFCT TYPE=SEGSET 


The pattern of segments for a particular data set is described using the 
DFHFCT TYPE=SEGSET macro instruction. As many segment sets as desired 
may be specified. If the only segment set required includes all the 
segments in the record, no DFHFCT TYPE=SEGSET macro instructions are 
necessary. A segment set of this type with a name of ALL is generated 
by the DFHFCT TYPE=SEGLAST macro instruction following the segment 
definitions. 


I i 1 " ITr,r 1 r ' 1 .. 

| IDFHFCT | TYPE=SEGSBT 

| | | ,S£GSET=name 

I I | ,SEGNAME= (name1[,name2],...) 

I—_ L_ I_._ 


l 

l 

l 

J 


TYPE=SEGSET 

is to describe the segment sets. 
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SBGSET=name 

specifies the eight—character symbolic name (label) assigned to 
a particular pattern of segments. This label is used in coding 
the DFHFC macro instruction when segment services are required. 
The label may be the same as one of the segment names specified 
previously in a SEGDEF macro instruction but must be different 
from any other SBGSBT name specified. The label ALL must not 
be used because CICS/VS automatically creates a universal 
segment set with this label. 


SEGNAME-(name1[ ,name2 ], ...) 

specifies the name of each segment to be included in the 
segment set, in the sequence in which the segment occurs in the 
segmented record. SEGNAME must be the same name as that 
specified in a previous DFHFCT TYPE=SEGDEF macro instruction. 


VSAM SHARED RESOURCES CONTROL —- DFHFCT TYPE=SHRCTL 


The DFHFCT TYPE=SHRCTL macro instruction can be used to control the 
sharing of VSAM resources by CICS/VS VSAM files and by IMS/VS VSAM data 
bases under CICS/OS/VS and DL/I OS/VS. Because both the entry that 
describes the VSAM data set and the entry that controls the sharing of 
resources are referred to by the file control program whenever I/O is 
requested of a data set that is sharing resources, it may be desirable 
to group together all data sets that share resources in the file control 
table, along with the entry to control the sharing of resources. This 
will keep the number of pages required to perform I/O on any of these 
data sets to a minimum. 

| The DFHFCT TYPE=SHRCTL macro must follow the entries for the VSAM 
| data sets that are sharing resources (that is, those that have 
i SERVR£Q=SHARE in DFHFCT TYPE=DAXASBT) . Shared resources are not allowed 
| when multiple user—catalogs are being used. 

If the file control table does not describe VSAM DL/I data sets, the 
DFHFCT TYPB=SHRCTL macro need not be specified, because the CICS/VS— 
supplied default version of the macro is suitable. 

If one or more VSAM data sets indicate that they are to share 
resources and this macro instruction has not been issued prior to the 
DFHFCT TYPE=FINAL macro instruction, the entry necessary to control the 
sharing of resources is automatically generated with all values 
defaulted. However, if VSAM DL/I data sets are described in the file 
control table, the DFHFCT TYPfi=SHRCTL macro must be specified with all 
parameters present. 

I Note : If CICS/OS/VS is being used with DL/I, the values specified in 
this macro cannot be changed by the IMS/VS DFSVSAMP statement. 


i— - 1 - r— ---1 



[DFHFCT 

i 

TYPE=SHRCTL 

i 


1 

i 

[ ,BUFFERS= (size,count[ ,...]) ) 

i 


1 

i 

[,KEYLEN=number ] 

i 


i 

i 

[,RSCLMT=number] 

1 


i 

i 

[,STRNO=number] 

1 


i_i___—i_-_______________1 
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TYPE=SHRCTL 

specifies that the entry required to control the sharing of 
VSAM resources is to be generated. 


BUFFERS= (size ,count[ , ... ]) 

is used to override part of the CICS/VS resource calculation. 
Each pair of values specifies a buffer size and a number of 
buffers of this size to be allocated. Each buffer size must be 
a power of 2, at least 512, or if greater than 2048, a multiple 
of 4096. The number of buffers of each size must be at least 3 
and less than 32768. If a given buffer size is not defined and 
it is required, the next larger buffer size will be used. When 
this parameter is specified, it overrides all of the buffer 
requirement calculation. The value specified in this parameter 
is exactly what will be passed to VSAM when the request is made 
to build the resource pool. If this parameter is not 
specified, CICS/VS will determine the buffer sizes required and 
the maximum number of buffers of each size and will allocate 
the percentage specified or implied via the RSCLMT parameter. 


KEYLEN=number 

is used to override part of the CICS/VS resource calculation. 
It specifies the maximum key length of any of the data sets 
that are to share resources. If not specified, CICS/VS will 
determine the maximum key length. 


RSCLMT=number 

indicates that CICS/VS will calculate the maximum amount of 
resources required by the VSAM data sets that are to share 
resources. Because these resources are to be shared, some 
percentage of this maximum amount of resources must be 
allocated. The RSCLMT operand specifies the percentage of the 
maximum amount of VSAM resources to be allocated. If this 
parameter is omitted, 50 percent of the maximum amount of 
resources will be allocated. If both the 5TRN0 and BUFFERS 
parameters are specified, RSCLMT will have no effect. 


STRNO=number 

is used to override part of the CICS/VS resource calculation. 

It specifies the total number of strings to be shared among the 
data sets that are to share resources. The value must be at 
least one and not more than 255. If a number is not specified 
for STRNO, CICS/VS will determine the maximum number of strings 
and allocate the percentage specified or implied in the RSCLMT 
parameter. 

IMS/VS users must ensure that the number specified in STRNO is 
large enough to allow for DL/I string requirements. The number 
of strings required by DL/I is equal to the number specified in 
| the DLTHRED operand (in DFHSIT) , plus one, plus the number of 

| sequential-mode DL/I data bases* CICS/VS will abend at 

| initialization if the number specified for STRNO is not large 

| enough to allow for (DLTHRED+1) strings to be reserved for 

I DL/I. Failure to allow for sequential—mode DL/I data bases may 

| result in conflicts between CICS/VS and DL/I in acquiring 

| strings during execution. 


Note s Users of IMS/VS VSAM data bases must specify their own values for 
the above parameters, and must not accept the default values generated 
by CICS/VS. 
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END OF FILE CONTROL TABLE — DFHFCT TYPE=FINAL 


The end of the file control table is indicated by the DFHFCT TYPE=FINAL 
macro instruction, which creates a dummy table entry to signal the table 
end* This macro instruction is the last statement in the assembly 
before the assembler END statement, except in CICS/DOS/VS where the user 
can also code the DFHFCT TYPB=LOGICMOD macro instruction* 

i-1- 

IDFHFCT | TYPE=FINAL 


TYPE^FINAL 

indicates the end of the file control table* 


EXAMPLES 


Figure 3.2-4 illustrates the coding that is required to create a file 
control table for three data sets. The first data set in the table is a 
cross—index data set that provides indirect access to a master data set 
and may reference a duplicate data set. The master data set requires 
segmenting services. 


DFHFCT TYPE=INITIAL START OF FILE CONTROL TABLE 

DFHFCT TYPE=DATASET, TABLE ENTRY FOR AN ISAM * 

DATASET=INDBX, DATA SET USED AS A CROSS- * 

ACCMETH=ISAM, INDEX DATA SET FOR A DATA SET * 

SBRYREQ= (UPDATE, NAMED MASTER* * 

NBWREC, THIS DATA SET MAY BE * 

INDACC), UPDATED AND ADDED TO* * 

RBCFORM= (FIXED,BLOCKED), * 

LRECL=37, * 

BLKSIZB=370, * 

BLKKEYL=5 
• 

• 

DFHFCT TYPE=INDACC, THIS DATA SET REFERENCES * 

OBJDSID=MASTBR, A DATA SET NAMED MASTER, * 

IARLKP=26, WHOSE KEY IS FOUND AT POSITION * 

IALKFL=11, 26. IT IS 11 CHARACTERS. * 

IADIII=FF, IT MAY POINT TO A DUPLICATES * 

DUPDSID=DUPLICA DATA SET NAMED DUPLICA. 

DFHFCT TYPE=DATASET, TABLE ENTRY FOR A BDAM * 

DATASET=DUPLICA, DUPLICATES DATA SET WHICH * 

ACCMETH=BDAM, CONTAINS KEYS TO THE MASTER * 

LRBCL—22, DATA SET. IT IS A READ-ONLY * 

SERVREQ= (GET) , DATA SET* * 

RECFORM^ (FIXED,UNBLOCKED) , * 

BLKSIZE-22 


Figure 3*2—4 (Part 1 of 2). File Control Table — Example 
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DFHFCT TYPE=DATASET, TABLE ENTRY FOR A VSAM * 

ACCMETH= (VSAM,KSDS) , DATA SET OWHICH MAY BE * 

SBRVREQ= (NEWREC # UPDATED, ADDED TO, DELETED * 

DELETE, FROM, AND BROWSED. * 

UPDATE, * 

BROWSE), * 

DATASET=VSAMDS, * 

STRNO=5, * 

PASSWD=GUESS 
• 

• 

DFHFCT TYPE=DATASBT, TABLE ENTRY FOR AN ISAM DATA * 

DATASET-MASTER, SET WHICH MAY BE UPDATED AND * 

ACCMETH=ISAM, ADDED TO, AND WHOSE RECORDS * 

SERVREQ= (UPDATE, ARE SEGMENTED. * 

NEWREC, * 

SEGMENT), ; * 

RECFORM= (FIXED,BLOCKED) , * 

LRECL=310, * 

BLKSIZE=1550, * 

RKP=11, * 

BLKKEYL=5 

DFHFCT TYPE=SEGHEAD, SEGMENT HEADER DESCRIPTION * 

SEGLENG=20, * 

INDDISP=2, * 

TSEGIND=BIT 

DFHFCT TYPB=SEGDEF, SEGMENT #1 OF THE RECORD IS * 

SEGNAME=5EGMENT 1, A FIXED—LENGTH, DOUBLEWORD * 

SEGCHAR= (FIXED, ALIGNED FIELD. * 

DOUBLE) , * 

SEGLENG=50 

DFHFCT TYPE=SEGDEF, SEGMENT #2 OF THIS RECORD IS * 

SEGNAME=SEGMENT2, A VARIABLE LENGTH HALFWORD * 

SEGCHAR=(VARIABLE, ALIGNED FIELD WHOSE MAXIMUM * 

HALF) , * 

SEGLENG=70 LENGTH IS 70 BYTES• 

DFHFCT TYPE=SEGDEF, SEGMENT #3 OF THE RECORD IS * 

SEGNAME=SEGMBNT3, A FIXED-LENGTH UNALIGNED * 

SEGLENG=45 FIELD 

DFHFCT TYPE=SEGLAST END OF SEGMENT DEFINITIONS 

DFHFCT TYPE=SEGSET, * 

SEGSET=PATTERN1, * 

SEGNAME= (SEGMENT1,SEGMENT3) 

DFHFCT TYPE=SEGLAST LAST SEGMENT ENTRY FOR MASTER 

DFHFCT TYPE=FINAL END OF FILE CONTROL TABLE 

| DFHFCT TYPE=LOGICMOD, CREATE VSE ISAM LOGIC MODULE * 

RPS=SVA UTILIZE BPS 

END 


Figure 3.2—4 (Part 2 of 2). File Control Table — Example 

Figure 3*2—5 illustrates the coding required to generate file control 
table entries for VSAM KSDS and VSAM ICIP KSDS data sets. 
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DFHFCT TYPE=DATASET, TABLE ENTRY FOR A VSAM * 

DATASET=VSAM1, KSDS DATA SET * 

ACCMETH= (VSAM,KSDS), * 

SERVREQ= (GET,PUT ,UPDATE,DELETE,NEWREC) , * 

FILSTAT= (ENABLED,OPENED) , * 

RECFORM=FIXED, * 

BUFSP=50000, * 

BUFNI=10 , * 

BUFND=11, * 

STRNO=10, * 

PASSWD=LETMBIN 

DFHFCT TYPE=DATASET, TABLE ENTRY FOR A VSAM * 

DATASET=VSAN2 , ICIP KSDS DATA SET * 

ACCMETH^ (VSAM,KSDS), * 

SERVESQ= (GET,PUT,UPDATE) , * 

FILSTAT= (ENABLED,OPENED), * 

RECFORM=FIXED , * 

BUFSP=50000, * 

BUFNI=8, * 

STRNO=15, * 

PASSWD=LETMBIN, * 

MODE= (ICIP), * 

INDEX= (VSAMIND1,1,INIT), * 

DATA=VSAMDAT1 


| Figure 3.2—5* File Control Table Example — KSDS Files 

Figure 3.2—6 illustrates the coding required to generate a VSAM mixed 
mode file. Two consecutive DFHFCT macros are required, as follows: 


DFHFCT TYPE^DATASET, DEFINES THE VSAM CHARACTERISTICS* 

DATASET=VSAM3, OF A VSAM MIXED MODE FILE TO BE * 

ACCMETH=(VSAM,KSDS), OPENED INITIALLY IN ICIP MODE * 

SERVREQ= (GET,PUT,UPDATE,DELETE,NEWREC), * 

FILSTAT=(ENABLED,OPENED) , * 


RECFORM=FIXBD, 
BUFSP=50000, 

BUFN1=10, 

STRNO=10, 

PASSWD=LETMEIN, 

MODE- (ICIP,MIXED) 

DFHFCT TYPE=ALTERNATB, 

DATASET=VSAM3, 

ACCMETH=(VSAM,KSDS), 
SERVREQ= (GET,POT,UPDATE) , 
FILSTAT= (ENABLED,OPENED) , 
RECFORM=FIXED, 
BUFSP=500Q0, 

BO F NI =8 , 

STRNO=15, 

PASSWD=LETMEIN, 

INDEX= (VSAMIND2,1 ,DYN) , 
DATA=VSAMDAT2 


. * 
* 
* 
* 
* 


DEFINES THE ICIP CHARACTERISTICS * 
OF A VSAM MIXED MODE FILE * 

* 
♦ 
* 
* 
♦ 
* 
* 
* 
* 


| Figure 3.2—6. File Control Table Example — Mixed Mode Files 
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Figure 3.2—7 provides an example of how to code a file control table 
that is to be used in conjunction with a VSAB alternate index. The VSAB 
file definition consists of four steps: 

1. Defining the base data set. 

2. Putting records into the base data set. 

3. Defining the alternate index path. 

4 * Creating entries in the alternate index. 


//DVSAB10B EXEC PGB=IDCABS DEFINE BASE DATA SET VSAB10B 

//VOLI DD VOL=SER=TST140,UNIT=3330,DISP=0LD 

//SYSPRINT DD SYSOOT=A 
//SYSIN DD * 

DEFINE CLUSTER (NAME(DTGCAT.VSAB1OB) - 
VOLUMES (TST140) RECORDS (500,50) - 

KEYS (10,14) RECORDSIZE (100,300) FRBESPACE(20,10) - 
SHAREOPTIONS (2) ) 

IF LASTCC=0— 

THEN— 

LISTC ENTRIES (DTGCAT*VSAM10B) ALL 

/* 


//RVSAN10B 

* 


EXEC PGM=IDCABS 


//INDSET1 DD 
//VSDSET1 DD 
//SYSPRINT DD 
//SYSIN DD 
REPRO 


PUT RECORDS FROM DATA SET 
ISAH4 INTO BASE DATA SET VSAM1QB 
DSN=TESTDATA.ISAN4,DISP=SHR,DCB=(DSORG=IS) 
DSN=DTGCAT.VSAB10B,DISP=OLD 
SYSOUT=A 
* 

INFILE (INDSET1) - 
OUTFILE (VSDSET1) 

IF BAXCC=0 - 
THEN - 

PRINT - 

INFILE (VSDSET1) - 
HEX 


//DVSAN10A EXEC PGB=IDCABS DEFINE ALTERNATE INDEX 

♦ PATH VSABIOP 

//VOL1 DD VOL=SER=TST140,UNIT=3330,DISP=OLD 

//SYSPRINT DD SYSOUT=A 

//SYSIN DD * 

DEFINE ALTERNATEINDEX (NABE (DTGCAT.VSAB10A) - 
FRBESPACE(20,10) - 

KEYS (10,31) - 

RECORDS (500,50) - 

RECORDSIZE (30,70) - 

RELATE PTGCAT.VSAB10B - 
NOUNIQUEKBY - 
UPGRADE 

SHAREOPTIONS (2) - 

VOLUMES(TST140)) 

DEFINE PATH(NAME(DTGCAT.VSAB10P) - 

PATHENTRY (DTGCAT.VSAB10A)) 


Figure 3*2—7 (Part 1 of 2). File Control Table Example — VSAB Alternate 
Index 
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//BYSAMIOA EXEC PGM=IDCAHS CREATE ENTRIES IN ALTERNATE 

* INDEX PATH VSAMIOP 

//VOL1 DD VOL=SER=TST140,UNIT=3330,DISP=OLD 

//BDSET1 DD DSN=DTGCAI.VSAM10B,DISP=OLD 

//ADSET1 DD DSN=DTGCAT.VSAHlOA,DISP=OLD 

//SYSPRINT DD SYSO0T=A 

//SYSIN DD * 

BLDINDEX INFILE (BDSET1) - 
OOTFILE (ADSET1) 

/* 


DFHFCT TYPE=INITIAL 

DFHFCT TYPE=DATASBT, DEFINE BASE DATA SET VSAM10B * 

DATASBT=VSAM10B, * 

ACCNETH=VSAH, * 

SERVREQ= (GET,POT,NEWREC,BROWSE,DELETE) , * 

RECFORH= (FIXED,BLOCKED) , * 

STRN0=5 

DFHFCT TYPE=DATASET, DEFINE ALTERNATE INDEX PATH VSAH10P * 

DATASET=VSAH10P, * 

ACCMETH=VSAH, * 

SERVREQ=(GET ,PUT,NEWREC,BROWSE,DELETE), * 

RECFORM= (FIXED,BLOCKED», * 

STRNO=5, 

FILSTAT=CLOSED 

DFHFCT TYPE=FINAL 

Figure 3.2—7 (Part 2 of 2). File Control Table Example — VSAM Alternate 
Index 


JCT — JODRNAL CONTROL TABLE 


The journal control table (JCT) is the means by which the user describes 
| journal files and their characteristics to CICS/VS for access through 
journal management. The JCT contains control information and operating 
| system control blocks describing each of the journal files. For VSE, 
the appropriate IOCS modules are assembled in the JCT. 


CONTROL SECTION — DFHJCT TYPE=INITIAL 


The control section into which the journal control table is assembled is 
established by the DFHJCT TYPE=INITIAL macro instruction. This macro 
instruction must be coded as the first statement in the source deck used 
to assemble the journal control table. 

i-1-1---1 

| | |DFHJCT | TYPE=INITIAL * | 

| | | | £ , SUFPIX^xx] * | 

i_s—___— — ______________- _i 

| * See the first page of this chapter. 
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JOURNAL ENTRIES — DFHJCT TYPE=ENTRY 


Each journal referred to during CICS/VS execution must have a JCT entry 
as generated by the DFHJCT TYPB=ENTRY macro instruction. Chapter 4.6 of 
this manual contains tutorial information concerning the choice of 
operands and values for the JCT. 


r 

i- 

r 

1 

i 

|DFHJCT 

| TYPE=ENTRY 


i 

i 

| ,JFILEID= (SYSTEM|nn} 


i 

i 

| ,BUFSIZE=nnnnn 


i 

i 

| [,BOFSUV=nnnnn] 


i i 

i 

| [,FORM&T=SMF] 


i 

i 

| [ ,J00R0PT= ([ CRUCIAL ][ ,INPOT ][ ,PA0SE][ ,BETBT ]) ] 


i i 

i 

1 r * JTYPE=(TAPE 11TAPE21 DISKI 1 DISK21SMF1 1 


i 

i 

1 r.OPEN=fINITIAL 1 DEFERRED! 1 


i i 

i 

| [ ,RSL={0|number} ] 


i 

■ 

i 

■ 

1 r,SYSWAIT= fSTARTIO1ASIS> 1 


1 

i 

l 

1 

i 

l 

| 

1 CICS/DOS/VS Only 


I 

i 

l 

i 

1 

| [ , DEVADDB= (SYSnnn[ , SYSmmm j) ] 


i 

t 

i 

i 

| [ ,JDEVICB={TAPB|2314|3330|3340|3350|FBA} ] 

1 


1 

1 

i_ 

1 

-I___ 

_1 


TYPE=ENTRY 

| specifies that an entry is to be generated in this table. 


JFILEID={SYSTEM|nn) 

specifies the journal file identification for this entry. 
SYSTEM 

indicates that the journal being defined is the CICS/VS 
system log. This log is required if CICS/VS is to perform 
automatic logging of changes to CICS/VS resources to 
support the emergency restart facility. In this case, 
JOUROPT=(CRUCIAL,INPUT) must be specified. The CICS/VS 
system log must have an associated BUFSIZE value of at 
least 1100 bytes if DL/I is used in CICS/OS/VS. 


is a decimal number between 2 and 99 that identifies the 
journal ID to be used. Leading zeros are not permitted. 


BUFSIZE=nnnnn 

specifies a decimal number indicating the number of bytes to be 
used as a buffer for journal I/O operations. The minimum is 
72. The maximum is 32767 for tape, the maximum track capacity 
for CKD disk devices, and 32761 for FBA devices* For 
CICS/OS/VS, BUFSIZE must be the same value as the DCB BLKSIZE, 

| and for DL/I logging, the minimum buffer size is 1100 bytes. 

For CICS/DOS/VS, if DL/I logging is being done through CICS/VS 
| journaling, the maximum buffer size is 1024 bytes. 
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BUFSUV=nnnnn 

specifies a decimal number to be used as a buffer shift-up 
value. The value must not be greater than the value specified 
| for BUFSIZE. The default is the BUFSIZE value. Refer to 

I Chapter 4.6 under the heading ‘Buffer Size 1 for a description 

| of the buffer shift—up technique ± 


| FORMAT-SMF 

| indicates that journal records will be written in SMF format. 

| It must be specified for journals used for the CICS/VS 

| Monitoring Facilities. 


JOUHOPT= ([ CRUCIAL ][ ,INPUT ][ ,PAUSB ][ ,RETRY ]) 

specifies which journaling option or options apply to the 
journal data set represented by this entry. 

CRUCIAL 

specifies that the journal data set is very important and, 
if it becomes inaccessible, CICS/VS is to be terminated. 

INPUT 

specifies that input operations are to be accepted for this 
journal data set. This option must be specified if 
emergency restart is required. 


PAUSE 

specifies that if volume switching is required for a disk 
journal data set, a message is sent to the console operator 
to ask when this switch may proceed. If this option is not 
specified, the alternate extent will automatically be 
reused, thus overwriting the previous journal records. 

RETRY 

specifies that output I/O errors are to be retried 
automatically on a new output volume before taking the 
action indicated by the CRUCIAL option. 


| JTYPE- (TAPE1 ITAPB2|DISKI IDISK2|SMF} 

specifies the type of journal data set being defined. The 
default is JTYPE=TAPE1• 

TAPE 1 

is a journal data set on one tape drive. 

TAPE2 

is a journal data set on two tape drives. 

DISKI 

is a journal data set on disk that has one extent to be 
reused when full. 

DISK2 

is a journal data set on disk that has two extents to be 
| used alternately. 
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SMF 


indicates, for MVS only, that information used by the 
CICS/VS monitoring facility will be sent to SMF (system 
management facilities) data sets, provided that the 
FORMAT=SMF operand is specified. Otherwise journal records 
will still go to non—SMF data sets. 


OPEN= (INITIAL | DEFERRED} 

specifies whether this journal file is to be opened by system 
initialization. The default is OPBN=INITIAL. 

INITIAL 

indicates that the journal file is to be opened for output 
by system initialization* 

DEFERRED 

may be used for journals that are opened by transactions 
that are executing under CICS/VS, or by programs that are 
specified in the program list table. 

Note : If the user wants to open a journal data set during 
execution, the VOLUME=FIRST parameter must be specified in 
the DFHJC T YPE=OPEN macro (see "Opening a Journal Data Set* 1 
in Chapter 4.6). 


| RSL={0|number} 

| indicates the security level, in the range 1 to 24, to be 

| associated with this resource (the journal)* The default is 

| RSL=0. 


SY SWAIT=f STARTIO |A SIS} 

indicates whether I/O is to be initiated immediately on 
synchronizing requests, namely PUT, (WRITE,WAIT), or WAIT, to 
this journal file from CICS/VS management modules* Note that 
this operand has no effect on user journaling requests. The 
default is SYSWAIT=STARTIO* 

STARTIO 

indicates that I/O is to be initiated immediately on 
synchronizing requests from CICS/VS management modules to 
the journal file. This option has the same effect as 
STARTIO=YES specified on all such requests. 


ASIS 

indicates that the option specified in the STARTIO keyword 
in the macro request is to be honored for synchronizing 
requests to the journal file from CICS/VS management 
modules* In almost all cases this will be STARTIO^NO* It 
is recommended that SYSWAIT=ASIS be specified only if the 
frequency of requests to the journal file is so high that 
the device becomes overloaded* 


CICS/DOS/VS Only 


DEVADDR= (SYSnnn[ ,SYSmmm]) 

specifies the user 9 s logical unit address for the journal data 
set ^ 
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SYSnnn 

specifies the logical unit address, where the nnn is a 
three-digit number from 000 to 255* 

SYSmmm 

specifies the alternate logical unit when two devices (tape 
or disk) are to be used for the journal data set. Like 
nnn, mnim is a three-digit number from 000 to 255 but cannot 
be equal to nnn* 


JDEVICE={TAPE|2314|3330|3340|3350|FBA} 

specifies the device type on which the journal data set is to 
reside. The default is JDEVICE=TAPE. 


END OF JOURNAL CONTROL TABLE — DFHJCT TYPE=FINAL 


The end of the journal control table is indicated by the DFHJCT 
TYPE=FINAL macro instruction. The assembler END statement must follow. 


r 

I 

L. 


I-1- 

|DFHJCT | TYPE=FINAL 


.1-i 


I 

j 


TYPE=FINAL 

indicates the end of the journal control table. 


EXAMPLE 

| Figure 3.2-8 illustrates the coding to create a journal control table 
(JCT) for three journals: 

• The system log, allocated two tape drives 

• Journal identification 2, allocated one disk extent 

• Journal identification 3, allocated two disk extents 

N ote : See the appropriate CICS/VS System Programmers Guide for 

execution—time JCL corresponding to this example. 
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I * 


DFHJCT TYPE=INITIAL 



DFHJCT TYPE=ENTRY, 

ENTRY FOR 

♦ 

JFILBID=SYSTEH, 

SYSTEM LOG 

4c 

JTYPE=TAPE2, 

TWO TAPE DRIVES ALLOCATED 

4c 

BUFSIZE=1500, 

BUFFER SPACE IS 1500 BYTES 

4c 

BUFSOV=1000, 

SHIFT UP POINT IS FULL 

4c 

DEVADDR= (SYS004 

r SYS005) , LOGICAL DEVICE ADDR 

•4c 

JOUROPT= (INPOT, 

RETRY,CRUCIAL) OPTIONS 


DFHJCT TYPE=BNTRY, 

ENTRY FOR 

4c 

JFILEID=2, 

JOURNAL ID 2 

4c 

JTYPE=DISK1, 

ONE DISK EXTENT ALLOCATED 

4c 

B0FSIZE=15OO, 

BUFFER SPACE IS 1500 BYTES 

4c 

BOFSOV=1500, 

AND •SHIFT—UP* WILL NEVER OCCUR 

4c 

JDEVICE =3 330, 

JOURNAL DEVICE 

4c 

DEVADDR=SYS006, 

LOGICAL DEVICE ADDR 

4c 

JOOROPT=RETRY 

OPTIONS 


DFHJCT TYPE=ENTRY, 

ENTRY FOR 

4c 

JFILEID=3, 

JOURNAL ID 3 

4c 

JTYPB=DISK2, 

TWO DISK EXTENTS ALLOCATED 

4c 

JOUROPT=(PAUSE, 

RETRY) , OPTIONS 

4c 

JDEVICE=2314, 

JOURNAL DEVICE 

4c 

DEVADDR= (SYS006 

,SYS007), LOGICAL DEVICE ADDR 

4c 

BUFSIZE=1000 

BUFFER SPACE IS 1000 BYTES 



SHIFT-UP VALUE DEFAULTS TO BUFSIZE 


DFHJCT TYPE=ENTRY , 

ENTRY 

4c 

JFILBID=4, 

FOR 

4c 

JTYPE=TAPE2, 

MONITORING 

4c 

DEVADDR=SYS008, 

FACILITIES 

4c 

FORHAT=SMF , 

JOURNAL 

4c 

BOFSIZE=1500, 


4c 

BUFS0V=15OO 



DFHJCT TYPB=FINAL 



END 




I Figure 3.2—8. Journal Control Table — Example 


| MCT - MONITORING CONTROL TABLE 

| The monitoring control table (MCT) describes the monitoring actions to 
| be taken at each user event monitoring point (BMP). Different actions 
| can be specified for each monitoring class at each BMP. It also \ 

| specifies where the data collected is to be recorded. 

| The monitoring facility is designed to provide one tool for 
| statistical information instead of using several existing tools. 

| The monitoring control table comprises the following macro 
| instructions: 

| • DFHMCT TYPE=INITIAL 

| • DFHMCT TYPB=BMP 

| • DFHMCT TYPE^RECORD 

| • DFHMCT TYPE=FINAL ■ 
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| CONTROL SECTION — DFHMCT TYPE=INITIAL 

I 

| The control section name for the CICS/VS monitoring control table is 
| established by the DFHMCT TYPE=INITIAL macro instruction. This macro 
| instruction also creates the necessary linkage editor control for 
I subsequent link-editing. 


I ( -,- r 


1 1 

IDFHMCT 

| TYPE=IHITIAL 

1 1 

1 

| [,BVENT=YBS] 

1 1 

1 

| [,SUFFIX=XX] 


I_t_L 


♦ See the first page of this chapter* 



* I 


j 


EVENT=YES 

indicates that, for MVS/SE2 systems only, CICS/VS will use the 
SYSEVENT macro to record the completion of all tasks when any 
of the monitoring classes are active. 


USER EVENT MONITORING POINTS — DFHMCT TYPE=EMP 


The DFHMCT TYPE=EMP macro allows the user to specify what action is to 
be taken when user event monitoring points (BMPs) are encountered in 
addition to those taken by the system. 

The TYPE=EMP macro must precede its associated TYPB=RBCORD macro. 


t -1-r-1 

| |DFHMCT | TYPE=EMP | 

| | | ,CLASS= ([ ACCOUNT ][, PERFORM]) I 

I | | ,ID=nuaber I 

| | | [ ,ACCOUNT= (optionf,...]) ] I 

| | I [ ,PERFORM=(option[ ,...]) ] I 

i-1-1-1 


TYPE=EMP 

indicates that the monitoring control table defines a user- 
specified event monitoring point* 


CLASS- ([ ACCOUNT ][ ,PERFORM ]) 

specifies the trace class that is valid for this EMP. The 
ACCOUNT and/or PERFORM operands must be specified* 

ACCOUNT 

indicates accounting trace class. 

PERFORM 

indicates performance trace class* 
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lD=number 


specifies a decimal integer in the range 0 through 255, which 
provides the numeric identification for this BMP in the trace 
invocation. User BMP identification should be restricted to 
values between 0 and 200, values between 201 and 255 are 
reserved for IBM use. It is advisable that the range of 
numbers used for this operand be kept small. 


ACC0UNT= (option[ ,..*]) 

specifies, for the accounting trace class, the events that will 
occur at this BMP. This operand must be specified if 
CLASS=ACCOUNT is specified. 

ADDCNT (1 , {m | DATA1 | DAT A 2} ) 

indicates that the counter is to be incremented by a 
hexadecimal constant "m" or, if DATA1 or DATA2 is 
specified, by the value of that field in the trace 
communication area. 

SUBCHT(1,{m|DATA1|DATA2} ) 

indicates that the counter is to be decremented by a 
hexadecimal constant "m" or, if DATA 1 or DATA2 is 
specified, by the value of that field in the trace 
communication area. 

NACNT(1,{m|DATA 1|DATA2}) 

indicates that a "logical and" operation is to be performed 
against the counter and hexadecimal constant "m M or, if 
DATA1 or DATA2 is specified, against the value of that 
field in the trace communication area. 

EXCNT (1,{m|DATA 1|DATA2}) 

indicates that a "logically exclusive or" operation is to 
be performed against the counter and hexadecimal constant 
"m M or, if DATA1 or DATA2 is specified, against the value 
of that field in the trace communication area. 

ORCNT (1 , {m | DATA 11 DAT A2} ) 

indicates that a "logically inclusive or" operation is to 
be performed against the counter and hexadecimal constant 
"m w or, if DATA1 or DATA2 is specified, against the value 
of that field in the trace communication area. 


PERF0RM= (option[ ,...]) 

specifies, for the performance trace class, the events that 
will occur at this BMP. This operand must be specified if 
CLASS=PERFORM is specified. 

ADDCNT (n,{m|DATA 11DATA2}) 

indicates that counter "n« is to be incremented by a 
hexadecimal constant "m H or, if DATA 1 or DATA2 is 
specified, by the value of that field in the trace 
communication area* 

SUBCNT(n,{m|DATA 11DATA2}) 

indicates that counter "n» is to be decremented by a 
hexadecimal constant "m" or, if DATA 1 or DATA2 is 
specified, by the value of that field in the trace 
communication area. 
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NACNT (n , (m | DATA 11 DATA2} ) 

indicates that a “logical and 11 operation is to be performed 
against counter “n“ and hexadecimal constant "a" or, if 
DATA1 or DATA2 is specified, against the value of that 
field in the trace communication area* 

EXCUT (n , {m | DATA 11DATA2} ) 

indicates that a “logically exclusive or” operation is to 
be performed against counter “n“ and hexadecimal constant 
“m M or # if DATA1 or DATA2 is specified, against the value 
of that field in the trace communication area. 

ORCNT (n, {m |DATA 11 DATA2}) 

indicates that a “logically inclusive or” operation is to 
be performed against counter “n“ and hexadecimal constant 
“m“ or, if DATA1 or DATA2 is specified, against the value 
of that field in the trace communication area. 

MLTCNT (n,number) 

specifies that, starting at counter ”n”, a number of 
counters are to be updated with a string starting at the 
address specified in DATA1* The number of counters updated 
will be the smaller of “number" and the value in DATA2, 
unless DAT&2 has a zero value, when “number” will be used. 

SCLOCK(n) 

indicates that clock “n“ is to be started. 

PCLOCK(n) 

indicates that clock ”n“ is to be stopped* 

MOVE (n,length) 

specifies that a string starting at the address specified 
in DATA 1 is to be moved to offset “n” in the user field. 

The maximum length (in bytes) that can be moved is given in 
the “length” parameter and the actual length to be moved is 
given in the DATA2 value, unless DATA2 has a zero value, 
when the “length” value will be used. 

Only one of the MLTCNT or MOVE parameters can be used per DPHMCT 
TYPE=EMP statement. 


CONTROL DATA RECORDING — DFHMCT TYPE=RECORD 


The DFHMCT TYPE=RECORD macro directs each active class of data captive 
to an external data set for recording and subsequent analysis. 

f-~r- 1 -:--—-1 



| DFHMCT 

1 

TYPE=HECOED 



1 

1 

1 

,CLASS= (ACCOONT|EXCEPTION|PERFORM} 

,DATASET=name 



1 

1 

# FREQ=number 



1 

1 

,MAXBUF=number 



1 

1 

[,CONV=YES] 




1 

C,CPO={YES|VS1|MVS|MFSSE|NO}] 



i_—- 1 -1__—--1 


TYPE=RECORD 

indicates that monitoring data will be recorded. 
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CLASS= {ACCOUNT|EXCEPTION|PERFORM} 

indicates the class of information that is to be recorded. 

ACCOUNT 

indicates that accounting class information is to be 
recorded. 

EXCEPTION 

indicates that exception class information is to be 
recorded. 

PERFORM 

indicates that performance class information is to be 
recorded. 


DATASET=name 

identifies the number of the journal (2 through 99) to which 
data is to be written. FORMAT=SMF must be specified in DFHJCT 
TYPE=ENTRY for the journal* 


FREQ=number 

indicates how often records are to be written to the data set. 
The number specified is in seconds and must be less than 86400. 
If a zero value is specified, the records are written out when 
the buffers become full. No system performance records will be 
produced if FREQ=0 is specified for performance class records. 


MAXBUF=number 

indicates the maximum size of the monitoring class*s buffer. 
The number specified is in bytes for CLASS-PERFORM and 
CLASS=EXCEPTION. For CLASS=ACCOUNT, the number specified, in 
bytes, will be rounded up to the next 2K—byte multiple. The 
value specified for the MAXBUF operand must be less than that 
specified for the BUFSIZE operand of the DFHJCT TYPE=BNTRY 
macro instruction for the related journal. 


CONV=YES 

indicates, for CLASS=PERFORM only, that conversational tasks 
will have separate performance class records produced for each 
pair of terminal control I/O requests. 


CPU= {YES|VS11MVS|MVSSE|NO} 

indicates that the amount of CPU time used by the task will be 
calculated using values from the supervisor. The default is 
CPU=N0. 

YES 

will provide values of DOS for CICS/DOS/VS or VS1 for 
CICS/OS/VS. 


VS 1 

indicates a VS1 supervisor. 

MVS 

indicates an MVS supervisor* 
MVSSE 

indicates an MVS/SE supervisor. 


Chapter 3.2. Table Preparation 


145 




I 

I 


indicates that this facility is not required 


NO 


| END OF MONITORING CONTROL TABLE - DFHMCT TYPE=FINAL 

I 

| The end of the CICS/VS monitoring control table is indicated by the 
| DFHMCT TYPE=FINAL macro instruction, which is the last statement before 
j the assembler END statement* 


I f - 1 -j- 1 

| | IDFHMCT | TYPE=FINAL | 

| L-1-1-1 

I 

| TYPE=FINAL 

| indicates the end of the CICS/VS monitoring control table. 


EXAMPLE 


DFHMCT 

TYPE=INITIAL 


DFHMCT 

TYPE=EMP, 

* 


ID=180, 

♦ 


CLASS= (PERFORM,ACCOUNT), 

* 


PERFORM = (SCLOCK (1) ,ADDC0UNT (2, 1) ) , 

ACCOUN T=ADDCOUNT(1,1) 

♦ 

DFHMCT 

TYPE=EMP, 

♦ 


ID=181, 

* 


CLASS=PERFORM, 

PERFORM=PCLOCK(1) 

* 

DFHMCT 

TYPB=RECORD 

♦ 


CLASS=ACCOUNT, 

* 


DATASET=2, 

* 


MAXBUF=4000, 

FREQ=3600 

* 

DFHMCT 

TYPB=RECORD, 

* 


CL A SS= PER FORM, 

* 


DATASET=3, 

* 


MAXBUF=8000, 

* 


FREQ=300, 

CP0=YES 

♦ 

DFHMCT 

TYPE=FINAL 

END 



NLT — NUCLEUS LOAD TABLE 


The nucleus load table has been provided to enable the CICS/VS user to 
| utilize virtual storage efficiently, by creating a load order which 
| provides the smallest possible working set* The table is used by 

CICS/VS to control the load order of the CICS/VS nucleus* It allows the 
CICS/VS user the option of changing the default load order established 
by the CICS/VS system initialization program. 

The modules specified in the nucleus load table are loaded in the 
order and at the relative location specified in each DFHNLT TYPE=ENTRY 
instruction. When all specified modules have been loaded, a default 
list is used to load the remaining modules. The default nucleus load 
table is contained in the system initialization module DFHSIB1• This 
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module would be a good reference for any installation considering 
altering the default list. 

Many CICS/VS nucleus modules are read-only, and the installation may 
choose to place some or all of these modules in the operating system*s 
shared area (the shared virtual area of VSE and the link pack areas of 
0S/VS1 and MVS). Refer to the appropriate CICS/VS System Programmer* s 
Guide (OS/VS or DOS/VS) for a list of eligible modules. 

Modules to be used from a shared area require entries in the nucleus 
load table, although those in the CICS/VS default table will suffice in 
most instances. Note that the ALIGN, FIX, ADRSPCE, PAGEIN, PAGEOUT, and 
PROTECT operands are not applicable to modules used from a shared area 
and will be ignored. 

For CICS/OS/VS, the specification of SHR=YES on nucleus load table 
entries identifies those modules which may be used from the link pack 
area when LPA=YES is specified on the DFHSIT macro or as a start—up 
override. The default nucleus load table (in module DFHSIB1) has 
SHR=YES indicated for all nucleus modules eligible for LPA residence. 

For CICS/DOS/VS there are no corresponding table or startup options, 
the use or otherwise of modules installed in the shared virtual area 
being determined by the core image library search order in effect for 
the CICS/VS execution* The default search order ensures that SVA 
resident phases are used. 

For further information on the use of CICS/VS modules in shared areas 
of the operating system refer to the appropriate CICS/VS Syste m 
Programmer*s Guide (OS/VS or DOS/VS) * 

The default load order for CICS/DOS/VS and CICS/OS/VS is shown below* 

Note ; The modules listed below with a preceding asterisk (*) are not 
loaded if the facility is not specified. 


CICS/DOS/VS 

ADDRESS MODULE OPTION FUNCTION 

SPACE 


LOW 


I 

I 

I 


DFHTCT 

DFHCSA 

DFHKCP 

♦DFHUEH 

DFHALP 

♦DFHEIP 

DFHSPP 

DFHXSP 

DFHZCP 

♦DFBZCA 

♦DFHZCB 

*DFHTCP 

♦DFHIRP 


DFHZCX 

*DFHZCY 

♦DFHZCZ 

DFHSCP 

DFHPCT 

DFHPCP 


ALIGNED 

ALIGNED 


ALIGNED 
ALIGNED 
ENTRY AL*D 


Terminal Control Table 

Common System Area 

Task Control Program 

User Exit Handler 

Allocation Progam 

EXEC Interface Program 

Sync Point Program 

External Security Program 

Terminal Control Common Interface 

VTAM Terminal Control Program 

VTAM Terminal Control Program 

BTAM Terminal Control Program 

Interregion Control Program 

Note : This module should always be 

installed in, and used from, the VSB 

shared virtual area for integrity 

reasons (MHO usage) 

BTAM and VTAM Terminal Control Program 
VTAM Terminal Control Program 
VTAM Terminal Control Program 
Storage Control Program 
Program Control Table 
Program Control Program 
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ADDRESS 

MODULE 

OPTION 

FUNCTION 

SPACE 

1 

DFHPPT 


Processing Program Table 


♦DFHFCT 

ALIGNED 

File Control Table 


♦DFHSDAM 


Direct Access Table 


DFHFCP 


File Control Program 


DFHTSP 

ALIGNED 

Temporary Storage Control Program 


♦DFHTST 


Temporary Storage Table 


♦DFHDCT 

ALIGNED 

Destination Control Table 


DFHTDP 


Transient Data Program 

t 

DFHUEM 


User Exit Manager 


♦DFHIIP 

ALIGNED 

Basic Mapping 


♦DFHM32 


Basic Mapping 

1 

DFHMCP 


Basic Mapping Control 


♦DFHTPP 


Basic Mapping 


♦DFHDSB 


Basic Mapping 


♦DFHPBP 


Basic Mapping 


CICS/VS 

DYNAMIC STORAGE AREA 


AND 




CICS/VS 

APPLICATION 

PROGRAM AREA 



♦DFHTRT 

HIGH 

Trace Table 

1 

DFHTRP 

HIGH 

Trace Control Program 

1 

♦DFHMCT 

HIGH 

Monitor Control Table 

1 

DFHCMP 

AL'D HIGH 

CICS Monitor Program 


DFHFDP 

AL 'D HIGH 

Formatted Dump Program 


DFHSCR 

AL'D HIGH 

Storage Control Recovery 


DFHKPP 

AL'D HIGH 

Keypoint Program 


♦DFHSRT 

HIGH 

System Recovery Table 


DFHSRP 

AL 'D HIGH 

System Recovery Program 


DFHMGT 

HIGH 

Message Table 


DFHMGP 

AL 1 D HIGH 

Message Program 

1 

DFHEEX 

HIGH 

EXEC FMH Extract Program 

1 

DFHEBU 

HIGH 

EXEC FMH Build Program 


*DFHISP 

HIGH 

Intersystem Communication Program 

1 

♦DFHXTP 

HIGH 

Transaction Routing Transformer 

1 



Program 

1 

♦DFHXFP 

HIGH 

Function Shipping 

1 



Transformer Program 


♦DFHBLR 

AL'D HIGH 

Intersystem EXEC Local/Remote Program 


DFHLFO 

HIGH 

LIFO Storage Program 


DFHDIP 

AL 'D HIGH 

Batch Data Interchange Program 


DFHDCP 

AL'D HIGH 

Dump Control Program 

1 

♦DFHSAP 

AL'D HIGH 

PL/I Service Module 


DFHBFP 

AL 'D HIGH 

Built-In Functions 


*DFHRLR 

AL'D HIGH 

Basic Mapping Route List 


♦DFHF2P 

HIGH 

Faster COMPAT 


♦DFHFIP 

AL'D HIGH 

Faster COMPAT 


♦DLZNUC 

AL'D HIGH 

DL/I Nucleus Module 

1 

*DFHJCOCP 

AL'D HIGH 

Journal Open/Close 


*DFHJCT 

HIGH 

Journal Control Table 


DFHJCP 

AL'D HIGH 

Journal Control Program 


DFHICP 

AL'D HIGH 

Interval Control Program 

HIGH 

DFHALT 

HIGH 

Application Load Table 
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cICS/OS/VS 


For CICS/OS/VS, the modules are loaded from high address space to low 
address space. The default load order is as follows: 


ADDRESS MODULE OPTION FUNCTION 

SPACE 


HIGH 


I 

I 

I 


I 


DFHCSA ALIGNED 
♦DFHEIP 

DFHKCP ALIGNED 
♦DFHUEH 
DFHALP 
*DFHKCSP 
*DFHZBPRX 
DFHSPP 
DFHXSP 

DFHICP ALIGNED 
DFHZCP 
*DFHZCA 
*DFHZCB 
DFHZCX 
*DFHZCY 
*DFHZCZ 
♦DFHTCP 
DFHTCT 

DFHSCP ALIGNED 

DFHALT 

DFHLFO 

♦DFHELR ALIGNED 
♦DFHXFP 
*DFHXTP 
*DFHISP 
DFHEBTJ 
DFHEEX 
DFHJCP 
*DFHJCT 
DFHPCT 

DFHPCP ENTRY AL 
DFHPPT 
DFHFCP 
DFHFCD 
*DFHFCT 
DFHDLI 
♦DFHDMB 
*DFHPSB 
DFHXSP 
*DFHTST 
DFHTDP 
♦DFHDCT 
DFHUEM 
♦DFHIIP 
♦DFHFIP 
♦DFHK32 
DFHMCP 
♦DFHTPP 
*DFHDSB 


Common System Area 
EXEC Interface Program 
Task Control Program 
User Exit Handler 
Allocation Progam 
HPO Task Control Module 

HPO VTAM Authorized Path Interface Module 
Sync Point Program 
External Security Program 
Interval Control Program 

Terminal Control Common Interface Program 
VTAM Terminal Control Program 
VTAM Terminal Control Program 
BTAM and VTAM Terminal Control Program 
VTAM Terminal Control Program 
VTAM Terminal Control Program 
Terminal Control Program (non—VTAM) 
Terminal Control Table 
Storage Control Program 
Applicatign Load Table 
LIFO Storage Program 
EXEC Local/Remote Program 
Function Shipping Transformer Program 
Transaction Routing Transformer Program 
Intersystem Communication Program 
EXEC FMH Build Program 
EXEC |MH Extract Program 
Journal Control Program 
Journal Control Table 
Program Control Table 
•D Program Control Program 
Processing Program Table 

File Control Program — common subroutines 

File control module for ISAM/BDAM 

File Control Table 

DL/I Interface Program 

DMB Directory (DL/I) 

PSB Directory (DL/I) 

Temporary Storage Program 
Temporary Storage Table 
Transient Data Program 
Destination Control Table 
User Exit Manager 
Basic Mapping 
FASTBR/Compat Program 
Basic Mapping 3270 
Basic Mapping Control 
Basic Mapping 
Basic Mapping 
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ADDRESS MODULE OPTION FUNCTION 

SPACE 


I 

I 

I 

LOW 


♦DFHPBP 


Basic Mapping Page Build 

♦DFHRLR 


Basic Mapping Route List 

*DFHF2P 


Basic Mapping FASTER/Compat 

DFHBFP 


Built-in Functions 

DFHDIP 


Batch Data Interchange Program 

*DFHSAP 


Storage Acquisition Program (PL/I) 

DFHSCR 


Storage Recovery Program 

DFHMGP 

ALIGNED 

Message Program 

DFHMGT 


Message Table 

DFHDCP 


Dump Control Program 

DFHSRP 


System Recovery Program 

DFHCRC 


Interregion STAE Exit 

Program (0S/VS only) 

*DFHSRT 


System Recovery Table 

DFHKPP 


Keypoint Program 

DFHFDP 

ALIGNED 

Formatted Dump Program 

DFHCMP 

ALIGNED 

CICS Monitor Program 

♦DFHMCT 


Monitor Control Table 

DFHTRP 


Trace Control Program 

♦DFHTRT 


Trace Table 


The CICS/VS default nucleus load tables are designed to give good 
performance across a wide range of applications and generation options. 
Changes to the default load order should be carefully considered, 
because improper use of the nucleus load tables can result in reduced 
performance. For example, the program control program (DFHPCP) is 
structured so that the working set instructions are at tne end of the 
| module following the entry point of the module. Thus, under VSE, if 
DFHPCP is loaded (as in the default load order) immediately before the 
processing program table (DFHPPT) and the ALIGN=ENTRY option is 
specified, the working set of DFHPCP will be loaded in the same page as 
the most—used portion of DFHPPT. This will reduce page—faults because 
DFHPCP uses DFHPPT more often than any other system table. 

The default nucleus load table attempts to provide the nest working 
set arrangement for CICS/VS. However, because of the many options 
available in CICS/VS, it may be possible for an installation to improve 
on the default loading of the nucleus. Before altering the default load 
order, the system programmer must carefully consider not only the module 
to be moved but also the effect on the neighboring modules. Modules may 
| be loaded adjacently because of their interrelated function or reference 
| (for example, the BMS modules). Care should be used in aligning modules 
because inadvertent choices can add to the working set rather than 
reduce it (for example, specifying ALIGN for both the PPT and the PCP 
would increase its working set). Alignment of modules can be used to 
isolate little-used functions (for example, aligning DCP) or to locate 
the working set of a module in as few pages as possible (for example, 
aligning SCP) . 

Each installation must study its requirements carefully, and then use 
the nucleus load table (if necessary) to order the CICS/VS nucleus into 
a configuration to suit its needs. 

The nucleus load table is an optional feature of CICS/VS. The 
nucleus load table to be used is specified in the system initialization 
table. If NLT=NO is specified in DFHSIT, the default load order will be 
used. 
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CONTROL SECTION 


DFHNLT TYPE=INITIAL 


The control section name for the nucleus load table is established by 
the DFHNLT TYPE=INITIAL macro instruction. This macro instruction also 
creates the necessary linkage editor control for subsequent link- 
editing. 


IDFHNLT | TYPB=INITIAL * | 

| | [,SUFFIX=xx] * | 

I I I 

I I CICS/OS/VS Only | 

I I I 

| | [ ,SHR={NO|YES} ] | 

.1-1-1 


| * See the first page of this chapter. 


CICS/OS/VS Only 


SHE-{NO|YES} 

provides a default specification of the SHE operand for all 
DFHNLT TYPE=ENTRY macro instructions corresponding to CICS/VS 
nucleus modules considered eligible for residence in the OS/VS 
link pack area, A list of these modules can be found in the 
CICS/VS System Programmer*s Guide (OS/VS) . The default is 
SHR=NO• 

NO 

indicates that the modules will not be used from the link 
pack area* 

YES 

indicates that the modules may be used from the link pack 
area. 

The CICS/VS default nucleus load table in module DFHSIB1 
has SHR=YES specified on the DFHNLT TYPE=INITIAL macro 
instruction. This specification will have no effect on 
CICS/VS execution unless LPA=YES is specified either on the 
DFHSIT macro or as a start up override. 


MODULE LOAD SEQUENCE — DFHNLT TYPE=ENTHY 


A specific nucleus module is defined to CICS/VS. Included in this 
definition is the information about where the module is to be loaded and 
the options with which the module is to be loaded. 

The DFHNLT TYPE=BNTRY macro instruction is used to specify the module 
load seguence. 
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T 


| IDFHNLT | TYPE=ENTRY 

I | | ,MODULE=nanie 

I | I [ ,ALIGN= {NO | ENTRY | YES} ] 

| | I CrPIX={NO|YES} 3 

| | | CICS/DOS/VS Only 

| | | [,ADRSPCB={LOW|HIGH} ] 

| | | [,PAGEIN={NO|YES}] 

| | | [,PAGEOUT={NO|YES} ] 

I I I 

| | | CICS/OS/YS Only 

I I I 

| | | [ ,PROTECT={NO|YES} 3 

II I I [,SHR={NO|YES} 3 


TYPE=ENTRY 

specifies that an entry is to be specified in the nucleus load 
table. 


MODULB=name 

specifies the nucleus module name. The name specified must be 
the basic module; suffixes are not required and will be 
ignored. 


ALIGN= {NO | ENTRY | YES} 

specifies whether any page-alignment of the module is to be 
performed. Page—alignment will only occur for the module(s) 
specified; all other modules will be packed in contiguous 
address space. The default is ALIGN=N0• 

NO 

specifies no page-alignment* Note that when ADRSPCE=HIGH 
| is specified for VSE, the end of the module is placed at 

the highest available address. 

ENTRY v 

specifies that the entry pointy of the module will be 
aligned on a page boundary when ADRSPCE=LOW is specified. 
This is useful when the working set of the module follows 
the module entry point and the entry point is not at the 
start of the module (see the note on DFHPCP in the section 
“Nucleus Load Table” above)• 

YES 

specifies that the beginning of the module is to be page- 
aligned to the start of a page, or that the end of the 
module is to be page-aligned to the end of a page if 
| ADRSPCE=HIGH (CICS/DOS/VS only) is specified, when the 

| module is loaded. The current ( implementation allows 

infrequently used modules and tables to be packed onto the 
same page. For example, specifying DFHJCP,ALIGN=YBS and 
DFHJCT,ALIGNING packs the two modules onto the same page 
with DFHJCP aligned on a page boundary• 
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Note: The ALIGN option must be used with care to optimize the 
size of the CICS/VS working set* Modules considered to be part 
of the normal CICS/VS working set should not normally be page- 
aligned, because page-alignment may force wasted address space. 
Example: A task control program always references the common 
system area (CSA). Packed into contiguous address space, this 
would normally occupy three 2K pages. If, however, both are 
page—aligned, four 2K pages would be used. 


FIX={NO|YES} 

specifies whether the module is to be page—fixed in real 
storage. Use of page-fixing should be carefully considered. 
Unnecessary page—fixing will only reduce the available real 
storage for paging and will probably adversely affect 
performance of both CICS/VS and concurrent batch work. If 
FIX=YES is specified, CICSSVC must he specified in the DFHSG 
TYPE=INITIAL macro for CICS/OS/VS. The default is FIX=NO. 

NO 

indicates that page—fixing is not required* 

YES 

indicates that the module is to be page—fixed. 

Note : The options of ALIGN, PAGEIN, and PAGEOUT have no 

meaning for a module which is fixed, and will be ignored if 
this operand is specified. 


CICS/DOS/VS Only 


ADBSPCE= {LOW) HIGH} 

specifies the partition area into which the module is to be 
loaded. LOW is the default. 

LOW 

specifies that the module is to be loaded at the low end of 
the partition. Modules normally included in the CICS/VS 
working set must be loaded at the low end to optimize use 
of the page data set (examples are DFHKCP, DFHTCP, and 
DFHCSA) . 

HIGH 

specifies that the module is to be loaded at the high end 
of the partition. Modules not normally to be included in 
the CICS/VS working set must be loaded at the high end 
(examples are DFHDCP and DFHSRP). 


PAGEIN={NO|YES} 

indicates whether the module is to be added to a page—in list. 
The page—in list will be used to initiate a page—in operation 
each time CICS/VS regains control after a VSE WAIT initiated by 
the task control program (KCP). The default is PAGEIN=NO. 

NO 

indicates that the module is not to be added to a page—in 
list. 
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YES 


indicates that the module will be added to a page—in list. 

Note: PAGEIN may be very useful in a low message rate system 
with concurrent batch operation, and all of the CICS/VS 
critical working set should be included. However, in a 
dedicated system, PAGEIN will cause additional processor 
utilization and its use should be avoided* 

Use of PAGEIN in a very active CICS/VS (high message rate) 
system must be carefully evaluated. 

PAGEIN^YES may not be specified for modules specified with 
ADRSPCE=HIGH. 


PAGEOUT={NO|YES} 

indicates whether the module is to be included on a page-out 
list. The page-out list will be used by the task control 
program to initiate page-out operations immediately before 
issuing a VSE WAIT. This will make those pages available for 
use by concurrent batch jobs. The default is PAGEOUT=NO. 

NO 

indicates that the module is not to be added to a page-out 
list. 


YES 

indicates that the module will be added to a page—out list* 

Note: Normally, only those modules not considered part of the 

CICS/VS working set should be included on the page-out list 
(examples are DFHDCP, DFHSRP, and DFHSCR)• The trace program 
and table must not specify PAGEOUT=YBS, because if trace is 
activated, these programs become highly referenced. 


CICS/OS/VS Only 


PROTECT={NO|YES} 

indicates, for MVS only, whether the module is to be loaded 
into a protected area of storage for a CICS/VS system that 
supports VSAM ICIP, VTAM authorized path, or both. The default 
is PROTECT=NO. 

NO 

indicates that the module is not to be loaded into 
protected storage. 

YES 

indicates that the module is to be loaded into a protected 
area of storage, and is to be used for CICS/VS nucleus 
modules that run in SRB mode. The SRBSVC operand must be 
specified in DFHSG TYPB=INITIAL for CICS/OS/VS under MVS. 

The default nucleus load table in the system initialization 
module (DFBSIB1) has the PROTECT=YES option coded for 
DFHKCSP and DFHZHPRX; it is set dynamically in DFHSIB1 for 
DFHFCP if VSAM ICIP is used. Modules for which PROTECT=YES 
is specified do not reside in the CICS/VS user storage 
area. 
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SHR=NO|YES 

indicates whether the (nucleus) module may be used from the 
OS/VS link pack area, if installed there, instead of being 
loaded into the CICS/VS partition. 

Nucleus modules installed in the link pack area may be shared 
by two or more CICS/VS systems in the same processor, thereby 
achieving an overall reduction in paging operations because of 
a reduction in total working set requirements. As the link 
pack area is key 0 protected, any CICS/VS module placed there 
is automatically protected from overwriting by erroneous code. 

The SHR operand may be specified on the DFHNLT TYPE=ENTRY macro 
instruction for those nucleus modules that are listed in the 
CICS/VS System Programmers Guide fOS/VS) as being eligible for 
residence in the link pack area. The default is the value of 
the SHE operand specified on the DFHNLT TYPE=INITIAL macro 
instruction. 

NO 

indicates that the module is not to be used from the link 
pack area (that is, it will be loaded into the CICS/VS 
partition). 

YES 

indicates that the module may be used from the link pack 
area if LPA=YES is specified on the DFHSIT macro 
instruction or as a start-up override. The use of the 
module from the link pack area requires that it has been 
installed there and that the module is not named by the 
PRVMOD start—up option (see the CICS/VS System Programmers 
Guide (OS/VS) for details) . 

If the module has not been installed in the link pack area, 
this will be detected by CICS/VS during system initialization 
and a message will be issued to the console operator. System 
initialization will then continue by loading the module from 
the CICS/VS program library (DFHRPL) into the CICS/VS partition 
in the usual way. 

To avoid searching the link pack area for modules not installed 
there and the associated console messages, it is recommended 
that the nucleus load table be tailored to the installations 
requirements. Note that the CICS/VS supplied default NLT in 
module DFHSIB1 has SflR=YES indicated for all modules considered 
to be LPA—eligible. 

Notes ; 

1* The ALIGN, FIX, and PROTECT operands are not applicable to 
nucleus modules used from the link pack area, and will be 
ignored. However, should a module, with SHR=YES specified, 
not be used from the link pack area, any options applicable 
to nucleus loading into the CICS/VS partition will be 
honored. 
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2. The EXEC interface modules do not have their own nucleus 
load table entries but effectively share those of their 
associated management modules* With EXEC=YBS in effect, 
the EXEC interface module is usually loaded first (and 
aligned if ALIGN=YES is indicated), and the management 
module is loaded, unaligned, immediately afterwards. 

The SHE operand value indicated in the nucleus load table 
entry for the management module will be assumed to apply to 
the associated EXEC interface module* However, this does 
not preclude using a management module from the link pack 
area, but not its EXEC interface counterpart, or vice- 
versa. The PRVMOD start-up option may be used to override 
the SHR=YES specification for one of the pair of modules 
concerned. 


END OF NUCLEUS LOAD TABLE — DFHNLT TYPE=FINAL 


The end of the nucleus load table is indicated by the DFHNLT TYPE=FINAL 
macro instruction, which is the last statement in the assembly of the 
nucleus load table before the assembler END statement* This macro 
creates a dummy entry to signal the table—end. 

i - 1 - 1 --- 1 

| (DFHNLT | TYPE=FINAL | 

i 1-1-*-- —j 


TYPE=FINAL 

indicates the end of the nucleus load table* 


EXAMPLES 


In general, CICS/DOS/VS installations should place unused or little—used 
pageable modules into the high address space of the partition. With 
only the heavily—used programs in low address space, the seek—time on 
the page data set for these modules will be reduced. This is due to the 
| organization of the page data set in VSE. 

| Example 1 illustrates a nucleus load table (Figure 3.2—9) for an 
installation with the following characteristics: 

• Some CICS/VS services are not used (journal control program, 
interval control program, built-in functions, and keypoint 
program) . 

• Some CICS/VS services (transient data control and dump control 
programs) are used only for error conditions or for a small 
percentage of application programs* 

• Trace program facilities normally off. 

• Concurrent batch processing* 

The entry for the DFHSDAM with ADRSPCE=HIGH indicates (for CICS/DOS/VS 
only) the assumption that no direct access files are defined in the file 
control table (FCT). 
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The DFHTRT does not specify alignment. If the trace table is 
specified as aligned, system initialization will round the trace table 
number of entries to fill a whole number of pages. Therefore, if it is 
desirable to force TRP and TRT into an integral number of pages, it must 
be done by aligning TRP (ALIGN =YES) and calculating the TRT size without 
specifying alignment. The TRT size specified in the system 
initialization table (or as a start-up override) must be calculated to 
round—up A the TRP alignment to even—page multiples. The number of trace 
table entries can be calculated by the following formulae: 


A0X=NO 

T= 

128 

(N-1) 

+ 

15 

AUX=TAPE 

T= 

128 

(N—4) 

+ 

110 

A0X=2314 etc 

T= 

128 

(N-4) 

+ 

80 

V 

CICS/OS/VS 






DLI= AUX= 






NO NO 

T— 

128 

(N-1) 

+ 

11 

NO YES 

T= 

128 

(N-4) 

+ 

76 

YES NO 

T— 

128 

(N-1) 

+ 

4 

YES YES 

T= 

128 

(N-4) 

+ 

68 


where T is the number of trace entries, and N is the number of pages 
(2K) devoted to the trace program. 

In an installation using the same facilities as Example 1 (below), 
but in a dedicated environment, the nucleus load table would be the same 
| as in Figure 3.2—9, except that PAGEIN and/or PAGEOUT must not be 
specified. 
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DPHNLT TYPE=INITIAL 

DFHNLT TYPE=ENTRY, * 

MODOLE=DFHJCP, * 

ADRSPCE=BIGH, * 

PAGEOUT=YES 

DFHNLT TYPE=ENTRY, * 

MODULE=DFHICP, * 

ADRSPCE=HIGH, * 

PAGEOUT=YES 

DFHNLT TYPE=ENTRY, * 

MODULE=DFHBFP, * 

ADRSPCB=HIGH, * 

PAGBOUT=YBS 

DFHNLT TYPB=ENTRY, * 

MODULE=DFHKPP, * 

ADRSPCB=HIGH, * 

PAGEOUT=YES 

DFHNLT TYPE=ENTRY, * 

MODULB=DFHSRP, * 

ADRSPCB=HXGH, * 

PAGEOUT=YES 

DFHNLT TYPE-ENTRY, * 

MODULB=DFHSCR, * 

ADRSPCE=HIGH, * 

PAGEOUT=YES 

DFHNLT TYPE=ENTRY, * 

MODULE=DFHTDP, * 

ADRSPCE=HIGH, * 

ALIGN^YES, * 

PAGEOUT=YES 

DFHNLT TYPE=ENTRY, * 

MODULE=DFHSDAM, * 

ADRSPCB=HIGH, * 

PAGEOUT=YES 

DFHNLT TYPE=ENTRY, * 

MOD U LB =DF HTR P, * 

ADRSPCE=HIGH, * 

ALIGN=YES 

DFHNLT TYPE^ENTRY, * 

MODULE=DFHTRT, * 

ADR$PCE=HIGH 

DFHNLT TYPE=FINAL 

END 

| Figure 3.2—9. Nucleus Load Table — Example 1 


| Example 2 illustrates a nucleus load table (Figure 3.2—10) for an 
installation with the following characteristics: 

• Some CICS/VS services are not used (temporary storage control 
program, basic mapping support, and built—in functions)* 

• Normal usage of all other CICS/VS facilities* 
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DFHNLT 

TYPE=INITIAL 


DFHNLT 

TYPE=ENTRY, 

♦ 


MODULE=DFHTSP, 

ADRSPCE^HIGH 

♦ 

DFHNLT 

TYPE=ENTRY, 

* 


MODULE=DFHBFP, 

ADRSPCB=HIGH 

* 

DFHNLT 

TYPE=ENTRY, 

♦ 


MODULE=DFHMCP, 

ADRSPCE=HIGH 

* 

DFHNLT 

END 

TYPE=FINAL 



| Figure 3*2—10. Nucleus Load Table — Example 2 

In an installation that is using the same facilities as in Example 2, 
except where there is potential interference from batch processing, the 
approach taken would be to specify PAGEIN for all modules that are part 
of the CICS/VS critical working set. 


PCT — PROGRAM CONTROL TABLE 


The program control table contains the control information to be used by 
CICS/VS for identifying and initializing a transaction. This table is 
required by CICS/VS to verify the incoming transaction request, and to 
supply information about the transaction such as the transaction 
priority, the security key, and the length of the transaction work area. 
Task control uses a portion of each PCT entry to accumulate transaction 
statistics. 

The following macro instructions can be specified in a program 
control table: 

• DFHPCT TYPE=INITIAL, which establishes the control section. 

| • DFHPCT TYPE=ENTRY, which specifies control information for a 

| transaction that is to run in this region. 

• DFHPCT TYPB=GROUP, which simplifies the specification of the 
transaction entries for CICS/VS~supplied transactions. 

| • DFHPCT TYPE-OPTGRP, which specifies the message protection options. 

| • DFHPCT TYPE=PROFILE, which defines the session processing options 

| for allocated sessions. 

| • DFHPCT TYPE=REMOTE, which defines transactions that are to be 

| executed in a remote system or region when CICS/VS 

I intercommunication facilities are used. 

• DFHPCT TYPE-FINAL, which concludes the program control table. 
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CONTROL SECTION — DFHPCT TYPE=INITXAL 


The control section into which the program control table is assembled is 
established by the DFHPCT TYPE=INITIAL macro instruction. 


I 

I 

I 


I 

I 

I 

I 


IDFHPCT | TYPE=INITIAL * 

| | [ ,DTB={NO|YES| (YES,NO) | (YES,WAIT)} ] 

I ) [,EXTSEC={NO|YES}] 

| | [ ,FDUMP={(ASRA,ASRB) | {ASRA[ASRB}} 

| | [ ,INDEX= {NO|Y ES} ] 

| | [,SCRNSZE= {DEFAULT|ALTERNATE}] 

| | [,SUFFIX=XX} * 

| | [ ,TRANSEC=([ MASTER (nn) }[ ,SVR (nn) 3[ ,FB (nn) }[ ,EDF (nn) 3 

| | [ ,INTERPRETER (nn) }[ ,MIRROR (nn) 3 

I I [,ROUTING (nn) }) 3 


| * See the first page of this chapter. 


| DTB= {NO|YES| (YES,NO) | (YES,WAIT)} 

| indicates whether entries in the PCT will require the dynamic 

transaction backout facility. The option specified in this 
macro can be overridden by that in the DFHPCT TYPE=ENTRY macro. 
Because a dynamic transaction backout buffer is not acquired 
until a protected resource is modified, the overheads involved 
for DTB=YBS for a transaction that never modifies a protected 
resource are negligiblei The default is DTB=NO. 

no 

indicates that the dynamic transaction backout facility is 
not required i 

YES 

indicates that the dynamic transaction backout facility is 
required for all the entries in this PCT. 

(YES, NO) 

| indicates, when CICS/VS intercommunication facilities are 

| used, that normal dynamic transaction backout facilities 

are required except when the session fails at a critical 
time during sync point or return processing. For full 
details on recovery for intercommunication facilities, 
refer to the CICS/VS System/Application Design Guide . 

(YES, WAIT) 

indicates that if an intersystem communication session 
fails at a critical time during sync point or return 
processing, then protected resources are to be neither 
committed nor backed out during the transaction abend, but 
are to be locked until the session is recovered. They are 
then committed or backed out in step with the remote 
system* 

This operand takes effect when the only protected resources 
changed ate changed by a WRITEQ TS or START PROTECT 
command, and when only one connection with a remote system 
exists for the transaction at the time of the sync point. 
Failing to meet these criteria forces DTB=YES• Refer to 
the CICS/VS System/Application Design Guide for further 
details in recovery facilities for CICS/VS 
intercommunication facilities. 
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EXTSBC= {NO | YES} 

indicates that an external security facility (for example, RACF 
for MVS systems) is to be used for all transactions listed in 
the PCT in place of the security facilities provided by CICS/VS 
(for example, transaction security provided by the TRANSEC 
operand in DFHPCT TYPE=ENTRY) unless EXTSEC=NO is specified for 
the individual entry. The default is EXTSEC=NO. 

NO 

indicates that the CICS/VS—provided security facilities 
will be used. 

YES 

indicates that an external security manager (for example, 
RACF under MVS, or a user-written facility) is to replace 
the CICS/VS-provided facility. EXTSEC=YES must also be 
specified in DFHSIT. 


FDUMP= { (ASRA , ASRB) | {ASRA | ASRB} } 

indicates the default value for the FDUMP (formatted dump) 
operand if the corresponding operand is not specified in a 
DFHPCT TYPE=ENTRY macro for this PCT* 

ASRA,ASRB 

indicates that a formatted dump will be taken after program 
interrupts (ASRA) and/or after operating system abends 
(ASRB). 


INDEX=(NO I YES} 

specifies whether indexing is to be used* In some 
| circumstances, indexing reduces the average time required to 

search CICS/VS tables by shortening the scan to locate entries* 
It also reduces the CICS/VS working set for large tables by 
reducing references to little—used or unused pages. Refer to 
the appropriate CICS/VS System Programmers Guide for further 
details. The default is INDEX=NO. 

NO 

indicates that indexing is not to be used. In this case, 
the PCT entries will be scanned sequentially; the most 
frequently used entries should be specified near the start 
of the table * 

YES 

indicates that indexing is to be used. When this option is 
specified, the entries in the PCT will be listed 
alphabetically by transaction—identification name. 

INDEX=YES must be specified when more than one of XTRANID, 
TRANSID, or TASKRBQ are used in any one DFHPCT TYPB=ENTRY 
| macro. 


SCRNSZE={DEFAULT|ALTERNATE} 

selects one of the two screen sizes (defined in the DFHTCT 
TYPE=TERMINAL macro) to be used for all the entries in the 
program control table that are not specified individually in 
DFHPCT TYPE 32 ENTRY macros. The default is DEFAULT. This 
operand also selects the buffer size for printers using a 3270 
data stream. For further information on the choice of screen 
sizes and buffer sizes, refer to the ALTSCRN and DEFSCRN 
operands in DFHTCT TYPE=TERMINAL• 
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DEFAULT 

~ indicates that transactions will be run in default screen 
size mode, using the values from the DSFSCRN operand in 
DFHTCT TYPE=TERMINAL* 

ALTERNATE 

indicates that transactions will be run in ••alternate* 1 
screen size mode, using the values from the ALTSCRN operand 
in DFHTCT TYPE=TERMINAL. 


TRANSEC=([ MASTER (nn) ][ ,SVR (nn) ][ ,FE(nn) ][ ,EDF (nn) )[ INTERPRETER (nn) ] 

[ ,MIRROR (nn) ][ ,ROUTING (nn) ]) 

allows the user to set the transaction security key value for 
transactions generated by the DFHPCT TYPE=GROUP macro for the 
following functions: 


MASTER — master terminal facility (CEMT or CSMT) 

SVR — supervisor functions (CEST or CSST) 

FE — field engineering terminal test facility and 

(CICS/DOS/VS only) facility error recognition 
system (FERS) 

EDF — execution (command level) diagnostic facility 
INTERPRETER -• command interpreter (CECI) 

MIRROR — mirror transaction (CSMI) 

ROUTING — routing transaction (CRTE) 

The value specified must be in the range 1 through 24. 


TRANSACTION CONTROL INFORMATION - DFHPCT TYPE=ENTRY 


| Transaction control information is provided to CICS/VS by the DFHPCT 
TYPE=ENTRY macro instruction. One TYPE=ENTRY macro must be generated 
for each transaction. Information provided by this macro instruction 
includes priority, security key, program identification, purge 
indicators, and size of the transaction work area. 

Some CICS/VS—supplied transactions must have entries in the PCT. 

| Most of these can be generated by DFHPCT TYPB=GROUP macro instructions. 

| Refer to Appendix A for a list of these special entries. 

When generating PCT entries for transactions, the system programmer 
can specify certain options for the transaction that relate to message 
protection and automatic journaling of terminal messages. In addition, 
a particular transaction may be restricted to run on logical units only. 

| The transaction control options that can be specified for LUTYPE6 
| logical units are described in the DFHPCT TYPE=PROFILE macro later in 
| this section. 
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1- 

1 

IDFHPCT 

"i "" .. .— .— 

| TYPE=BNTRY 

- 


i 

| ,PROGRAM=name 



i 

| ,TASKREQ=xxxx 



i 

| ,TRANSID=transaction—identification 



i 

| r,ANTICPG=IMP 1 YESinnl 1 



i 

1 f.CLASS 9 * (LONG 1SHORT} 1 



i 

| [ ,COMPAT= {NO|FORMAT|FULLBOF) ] 



i 

| [, DTB=(NO|YESj (TBS,NO)| (TBS,WAIT)} ] 



i 

| [,DTIHOOT={NO|numeric-value}] 



i 

I r,DOMP=(TBSINOl1 



i 

| [,DVSUPRT={ALL|NONV|VTAH}] 



i 

| [,EXTSEC={TSS|NO}] 



i 

| [ ,FDUHP={ (ASRA, ASRB) | ASRA | AS SB} ] 



i 

| r ,PRIYATE= (NO 1 TBS} 1 



i 

1 [,RAQ={NO|TES}] 



i 

| [ , RESTART= {NO | YES} ] 



i 

| [,RSL= {01number} 



i 

| [,RSLC={NO|TBS}] 



i 

j f.RTIH0PT=(NO 1 numeric—value)1 



i 

| [,SCRNSZE={ALTERNATE|DEFAULT}) 



i 

| [,SPURGE={NO|TES}] 



i 

| [,TCLASS= {NO|task-class} ] 



i 

| [ ,TPDRGE={NO|TES} ] 



i 

| [,TRANSEC=Q|decimal—value}] 



i 

j [,TRNPRTT={1|decimal—value}] 



i 

1 T.TRNSTAT=(ENABLED1 DISABLED} 1 



i 

| [,TWASIZE={0|decimal—value}] 



i 

i 

| [,XTRANID=hexadecimal—itransaction—identification) 

| 



i 

i 

1 

1 VTAM Only 

I 



1 

i 

| [,EXTRACT={NO| (ATTACH)} ] 



i 

| [,INBFHH={BODS|ALL|DIP|NO}] 



i 

| f »JFILEID= (NO 1 STSTEM 1 nnl } 



i 

| f ,LOGREC= (NO 1 TBS) 1 



i 

| [,MSGJRNL={INPUTJOUTPUTI (INPUT,OUTPUT)} ] 



i 

| [,NEPCLAS={0|integer} ] 



i 

i 

| [,OPTGRP=name] 

I 



1 

i 

l 

1 

1 CICS/OS/VS only 

I 



1 

i 

| [,PRHSIZB=decimal—value] 


1_ 

i_ 

1 . . . . .... .. . ._ 

_1 


TYPE=ENTRY 

specifies that an entry is to be generated in this table. 


PROGRAM=name 

specifies the initial program identification; this operand 
specifies the name of the program to which control is to be 
given to process this transaction. This program must also be 
defined in the PPT. 
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TASKREQ=xxxx 

specifies one of the special PA or PF keys, the operator 
identification card reader (OPID), a light pen detectable field 
on a 3270, or the 10/63 character magnetic stripe reader. 
Specifying this parameter indicates that a task is to be 
initiated in response to the operator striking one of these 
special keys, reading the operator identification card, 
selecting a light pea detectable field (LPA) , or using the 
10/63 character magnetic stripe reader. Valid specifications 
are: 


PA 1, PA2, or PA3 — for PA keys. 

PF1 through PF24 — for PF keys. 

OPID — for the operator identification card reader. 

LPA — for a light pen detectable field on a 3270 device. 

MSRE for the 10/63 character magnetic stripe reader. 

Either TASKREQ or TRANSID (or both operands) must be specified. 
XTRANID may be specified with either or both operands. 

It more than one of these operands is specified in a single 
DFHPCT TYPE=ENTRY macro, only one PCT entry is created. For 
the purposes of statistics and tracing, all the uses of this 
entry are collected under the TRANSID name (or under TASKREQ if 
TRANSID is not specified). INDEX=YES must be specified in 
DFHPCT TYPE=INITIAL. 

Note: There are several, possibly conflicting, uses of the 
3270 PA/PF keys. In order of interpretation these uses are: 


I 

I 

I 


I 

I 


1. To initiate printing, as specified in the PRINT operand of 
the DFHSIT macro or at system start—up. Once so defined, 
the key cannot be used to initiate a task. It can, 
however, be used while a task is running for a purpose 
defined by that task. 

2. To initiate a task, as specified in the TASKREQ operand 
above. The same key can also be used for purpose 3 below. 

3. For page retrieval, as specified in the SKRxxxx operand of 
the DFHSIT macro. The same key can also be used for 
purpose 2 above; it is interpreted as a page retrieval 
function only during a page retrieval session. It cannot 
be used to initiate other transactions. As a special case, 
if PROGRAM~DFHTPR and TASKREQ-xxx are specified in the 
DFHPCT TYPE=ENTRY macro, the key will also open the page 
ret r ie va 1 se s sio n. 


TRANSID=transaction-identification or *transaction—identification 1 

specifies the one— to four-character transaction identification 
| assigned to the individual transaction. INDEX=YES must be 

| specified in DFHPCT TYPE=INITIAL if either the TASKREQ or 

| XTRANID operand is used in conjunction with TRANSID. 

| Transaction identifications beginning with the letter "C” may 

| conflict with CICS/VS—provided transactions; see the current 

| list in Appendix A. 

The following rules apply when specifying the TRANSID operand: 

• If the operand begins and ends with apostrophes, it is 
assumed that they are only framing characters. They will 
not become part of the actual character string in the PCT 
entry. 
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• If an ampersand (S) or an apostrophe ( w ) is required as one 
of the characters for the TRANSID specification, two 
ampersands or apostrophes must he specified where the one 
is required. The assembler converts these double 
characters into single ones. 

• The resultant length of the TRANSID after the above 
adjustment must not exceed four characters. 

• If any of the special characters comma, left or right 
parenthesis ( H , H , 11 (" or ")") is required as part of the 
TRANSID, the framing apostrophes must be used. 

• The TRANSID must not include a blank or a field separator 
character. 

When the transaction is entered at the terminal, the delimiters 
of the transaction identification are searched for as follows: 


| blank 

| field separator character (specified by FLDSEP in the SIT) 

| field name start character (specified by FLDSTRT in the SIT) 

| 4 characters 

The 3287 printer includes Program Access keys (PA1 and PA2), 
which are only available when the 3287 is operating as an SNA 
SCS printer (TRMTYPE=SCSPRT). Pressing one of these keys may 
generate an inbound data stream that consists of the characters 
"APAK 01" or "APAX 02" for PA 1 and PA2 respectively. When a 
transaction is not currently attached to a printer, the PA1 and 
PA2 keys can be made to initiate a transaction by specifying 
TRANSID=APAK as the transaction name. For further information 
on the use of Program Access keys on the 3287, refer to the 
3270 Information Display System Components Descriptio n manual 
| and the CICS/VS IBft 3270 Guide . 


ANTICPG={NO | nn | YESJ 

specifies whether anticipatory paging is to be performed on the 
task control area (TCA), the data areas, and on the application 
program code. The default is ANTICPG=NO. 

NO 

indicates that anticipatory paging is not to be performed, 
nn 

specifies a decimal value from 1 through 15 to indicate the 
number of consecutive pages that are to be initially 
acquired for the task f s TCA and data areas, and to be paged 
in and out asynchronously. 


YES 

indicates that one page is to be acquired initially. 
Notes : 

1. ANTICPG=nn and ANTICPG=YES require the CICSSVC operand in 
the DFHSG TYPE=INITIAL macro, and CLASS=LONG must be 
specified (or allowed to default) in DFHPCT TYPE=ENTRY. 
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I 2. In VSE, unused pages at the "high end” of anticipatory 

paging storage for an isolated task (one that is specified 
with PRIVATE=YBS or CLASS=LONG) are not paged in or out. 

I This is significant because VSE will not acquire real 

storage for unused pages. OS/VS is aware, through its page 
tables, that certain pages have not been used. 


CLASS= (LONG | SHORT} 

defines the relative longevity of the task initiated by the 
defined TRANSID. CICS/VS treats each task class in a manner 
that minimizes page faults occurring during the processing life 
of the task. The default is CLASS=LONG. 

LONG 

identifies tasks of long or unpredictable duration; 

typically, these include: 

— Tasks involved in conversational activity with a 
terminal operator. 

— Large or unknown volume data collection, data 
transmission, or data manipulation type tasks. 

— CICS/VS journal tasks (TRANSID=CSJC). For additional 
information, see "Journal Management" in Chapter 4.6 of 
this manual. 

I This option must be specified (or allowed to default) when 

ANTICPG=nn or YES is specified* 


SHORT 

is used to identify short—duration tasks; typically, these 
include: 

— Single input/single output inquiry tasks 
(nonconversational terminal activity). 

— Small volume data collection tasks; 

— Data transmission tasks communicating with high speed 
terminals transmitting small batches of data at a time. 

— Small volume data manipulation type tasks^ 

This option must be specified when the PRMSIZE operand is 
used. 


Note : In many cases, a short-duration task may perform better 
if defined to CICS/VS as a long-duration task and possibly as 
an anticipatory paging class of task with a predefined number 
of pages. This may be true if the task will use large amounts 
of virtual storage (via GETMAIN/FREKMAIN). The instruction 
pathlength through the storage control program will be shorter 
for a long-running (isolated) task than for a short-running 
task, if the short—running task causes the storage control to 
go through page acquisition. Also, an anticipatory paging 
class of task will not be dispatched until all the virtual 
storage areas it will reference are in real storage (thus 
minimizing page—faulting). 
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COMPAT= {NO | FORMAT | FULLBUF} 

indicates the transactions that are to be run in 2260 
compatibility mode on the 3270 Information Display System. 

Note: 2260 compatibility is not supported for 3270s operating 

through VTAM• In these cases, this operand is ignored. 
C0MPAT=N0 is the default. 

NO 

indicates that 2260 compatibility is not required. 

FORMAT 

indicates that the transaction is to be run in FORMAT mode. 
FULLBUF 

indicates that the transaction is to be run in PULLBUP 
mode. 

For a discussion of the FORMAT and PULLBUF modes of 2260 
compatibility, see the section “2260 Compatibility for the 
3270” in Chapter 5.5 of this manual* 


| DTB= (NO | YES | (IBS,NO) | (YES,WAIT) } 

indicates whether the dynamic transaction backout facility, for 
backing out the effects of a transaction that terminates 
abnormally, will ne reguired. If this operand is omitted, the 
DTB option from the DPHPCT TYPE=INITIAL macro is taken. 

| However, if RESTART=YES is specified, DTB will default to a 

I value of YES. 

Because a dynamic transaction backout buffer is not acquired 
until a protected resource is modified, the overheads involved 
for DTB=YES for a task that never modifies a protected resource 
are minimal. 

NO 

indicates that the dynamic transaction backout facility is 
not required. 

YES 

indicates that the dynamic transaction backout facility is 
required* 

(YES, NO) 

| indicates, when CICS/VS intercommunication facilities are 

I being used, that normal dynamic transaction backout 

facilities will be provided, except when the session fails 
at a critical time during sync point or return processing. 
Refer to the CICS/VS System/Application Design Guide for 
further details on recovery facilities for CICS/VS 
| intercommunication facilities* 
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(YES,WAIT) 

indicates that if an intersystem communication session 
fails at a critical time during sync point or return 
processing, then protected resources are to be neither 
committed nor backed out during the transaction abend, but 
are to be locked until the session is recovered. They are 
then committed or backed out in step with the remote 
system. 

This operand takes effect when the only protected resources 
changed are changed by a WRITEQ TS or START PROTECT 
command, and when only one connection with a remote system 
exists for the transaction at the time of the sync point. 
Failing to meet these criteria forces DT3=YES. Refer to 
the CICS/VS System/A p plicat i on Design Guide for further 
details on recovery for CICS/VS intercommunication 
facilities* 


DTIMOUT=(NO I numeric—value} 

indicates the length of time after which the deadlock time-out 
facility will terminate a suspended task in such cases as a 
short-on—storage condition, a temporary storage SUSPEND, or 
where a task is suspended after having issued a request to a 
remote system while the link is in use. The default is no 
deadlock time-out value (DTIMOUT=NO) , which will not terminate 
the suspended task. The task that is timed out will receive an 
ARCS (deadlock time-out) abend. 

NO 

indicates that the deadlock time-out feature is not 
required. 

numeric—value 

specifies the length of time (BBSS for minutes and seconds) 
after which the deadlock time-out facility will terminate a 
suspended task* The maximum value that can be specified is 
70 minutes and is accurate to intervals of one second. 

Note that, if this option is specified, a transaction that 
has SPURGE=N0 specified will be terminated after the 
interval specified in the DTIMOUT operand. 


DUMP={YES|NO} 

specifies whether a dump is to be produced if the transaction 
terminates abnormally. The default is DUMP=YES. Note that 
this operand has no effect on an EXEC CICS DUMP command, which 
will always produce a dump* 


DVSUPRT={ALL|NONV|VTAH} 

identifies transactions that are permitted to execute only on a 
terminal or logical unit supported by a particular access 
method as specified in the associated TCTTE. The default is 
ALL. 

ALL 

indicates that the transaction can execute with any 
terminal or logical unit. 

NONV 

indicates that the transaction may only execute with start- 
stop and BSC terminals. 
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VTAM 

indicates that the transaction can only execute with 
logical units. 


EXTRACT={NO| (ATTACH)} 

specifies whether function management headers are to be removed 
from input data. The default is BXTRACT=NO. 

NO 

specifies that no function management headers are to be 
removed from input data during command level processing of 
RECEIVE and CONVERSE commands. 

(ATTACH) 

specifies that the type 6 logical unit attach function 
management headers are to be removed from input data during 
command level processing of RECEIVE and CONVERSE commands. 

The EXTRACT operand has no effect for macro level programs 
or when no function management headers are to be passed to 
the application program. That is, specification of 
INBFHH=NO overrides the EXTRACT operand. 


EXTSEC= {NO | YES} 

indicates whether an external security facility (for example, 
RACF for HVS systems) is to be used for this transaction 
instead of the security facilities provided by CICS/VS through 
the TRANSEC operand. If this operand is omitted, the EXTSEC 
value is taken from that specified in the DFHPCT TYPE=INITIAL 
macro instruction. 

NO 

indicates that only the security facilities provided by 
CICS/VS will be used for this transaction. 


YES 

indicates that an external security facility will be used 
for this transaction. EXTSEC=YES must also be specified in 
the DFHSIT macro, and in the DFHSNT TYPE=ENTRY macro. 


| FDUMP={ (ASRA,ASRB) |ASRA| ASRB} 

indicates whether the formatted dump program is to be invoked 
if the transaction terminates with a program interrupt (ASRA), 
or with an operating system abend (ASRB). If this operand is 
specified, a formatted dump will be taken in addition to a 
transaction dump* This operand defaults to the FDOMP option in 
DFHPCT TYPE=INITIAL. If neither operand is specified, the 
formatted dump program will not be invoked. 

ASRA 

indicates that a formatted dump will be taken after a 
program interrupt* 


ASRB 

indicates that a formatted dump will be taken after an 
operating system abend* 
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INBFMH= fgODSI ALLtDIP INO) 

applies to transactions running on logical units. By 
generating this parameter the user can specify whether a 
function management header (FMH) received from a logical unit 
is to be passed to the application program*s TIOA. The default 
is INBFMH=EODS. 

EODS 

indicates that an FMH is only passed to the application 
program if it indicates end of data set (EODS)• 

ALL 

| indicates that all FMHs (except LUTYPE6 ATTACH and 

| SYNCPOINT FMHs which are processed by CICS/VS) are passed 

| to the application program. This operand is required for 

| transactions that use Distributed Transaction Processing. 

DIP 

indicates that the batch data interchange program (DFHDIP) 
is to process inbound FMHs. BMS will issue a batch data 
interchange receive request if a BMS receive request has 
been issued, and a batch data interchange received request 
is issued instead of a terminal control receive request. 

NO 

indicates that the FMHs are discarded* 


JFILEID={NO|SYSTEM|nn} 

specifies where records generated during automatic journaling 
are to be stored* The default is NO. 

NO 

indicates that no automatic journaling of messages is to 
take place* 

SYSTEM 

indicates that automatic journaling for logical units is to 
be performed on the system log when this transaction is 
executing. 


nn 

indicates the journal ID to be used for automatic 
journaling. This may be any value from 2 through 99. 

Note : If automatic journaling is specified, the journal 

control program and journal control table parameters must be 
specified to support the TCP automatic journaling reguests. 


LOGREC={NO|YBS} 

| specifies whether the application wants each EXEC ClCS RECEIVE 

| request to be satisfied by a logical record. This option 

allows existing 2770- and 2780-based application programs to be 
attached to a batch logical unit without modification to the 
program. The default is L0GRBC=N0. 

I NO 

| indicates that this function is not required. 

| YES 

| indicates that this function is required. 
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I MSGJRNL={INPUT |OUTPUT | (INPUT,OUTPUT) } 

indicates whether automatic journaling is to be performed when 
the transaction is running on a logical unit. If this operand 
is specified, JFILEID is also required. 

INPUT 

indicates that journaling is required for input messages. 


OUTPUT 

indicates that journaling is to be performed for output 
| messages. 


NEPCLAS={0|integer} 

defines the class of the transaction for the node error program 
module (DFHZNEP). Integer is a value between 0 and 255; note 
that specifying 0, or a value greater than 255, will result in 
a subsequent link to the default transaction class routine (see 
11 User—Written Node Error Programs" in Chapter 4.3). The 
default value is 0. The identifying integer is placed in the 
PCT for reference by the DFHZNEPI TYPE=ENTRY macro instruction. 


OPTGRP^name 

specifies the name of the particular message option group. The 
message option group is generated by a DFHPCT TYPE=OPTGRP macro 
instruction. If this operand is not specified, no message 
protection options are available to the task. This operand 
applies to logical units only. 


PRIVATE={NO|YES} 

specifies the type of storage area in which the task is to run* 
The default is PRIVATB=NO. PRIVATE=YES has the same internal 
effect in CICS/VS as a specifying CLASS=LONG. 

NO 

indicates that this task can run in the same storage area 
as other tasks. 

YES 

indicates that CICS/VS will attempt to isolate the storage 
allocated to the task from other active tasks in the 
system. This option can be used during a trial period for 
new transactions, or as required by the user. 


RAQ=fN0tYES1 

indicates whether the read ahead queuing option is required. 

The default is RAQ=N0• 

NO 

indicates that the transaction will obey SNA protocols and 
only SEND and RECEIVE when in the correct mode. If it does 
not follow the protocol then it may be abended with code 
ATC7 • 
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YES 


indicates that the transaction may violate SNA protocols, 
and CICS/YS will queue incoming data on temporary storage 
until specifically requested by the transaction. RAQ=YES 
is provided only for compatibility with transactions which 
support both bisynchronous devices and logical units, and 
its use is not recommended. If RAQ=YES is specified, then 
the temporary storage program must be generated and the 
correct control interval size for the largest message 
calculated. 


BESTART={NO| YES} 

indicates whether the transaction restart facility is to be 
used to restart those tasks that terminate abnormally and are 
subsequently backed out by the dynamic transaction backout 
facility (DTB=YES)• The default is RESTART=NO• 

If RESTART=YES is specified, the task that failed is restarted 
from the beginning of the initial program. If dynamic 
transaction backout fails, or if restart is suppressed 
dynamically, DFHPBP will be invoked in the normal way* The 
transaction restart facility is especially useful in such 
situations as a program isolation deadlock, where the task can 
be restarted automatically rather than resubmitted manually. 

NO 

indicates that the restart facility is not required. 

YES 

| indicates that the restart facility is to be used. DTB=NO 

I may not be specified as it will conflict with this RESTART 

| value. 


| RSL={0 | number} 

| indicates the security level, in the range 1 to 24, to be 

I associated with this resource (the transaction). The default 

I is RSL=0. 


RSLC= {NO | YES} 

indicates whether resource security level checking is to be 
performed. The default for the EDF and command interpreter 
transactions, and for the transaction CSMI, is RSLC=YES. If 
the resource has a RSL value of zero, then no access is allowed 
by transactions which have RSLC=Y£S specified. The default is 
RSLC=NO• 


RTIMOUT={NO|numeric—value} 

is used to specify the timeout value for the read time-out 
feature. The default is no read time-out value (RTIMOUT=NO). 
I The task that is timed-out will receive an AKCT abend. 

NO 

indicates that the read time-out feature is not required. 
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numeric—value 

specifies an interval (MMSS for minutes and seconds) after 
which the task will be terminated if no input has been 
received from the terminal. The maximum value that can be 
specified is 70 minutes. The value specified in this 
option is rounded up to units of 16.73 seconds. Thus, the 
minimum value (after rounding—up) is 16.78 seconds. If 
this operand is not generated, or if a zero value is 
specified, no read time-out will occur. Instead of 
specifying a numeric parameter, the user may specify a 
symbol previously defined as a numeric value. 


SCRNSZE=(ALTERNATE|DEFAULT} 

selects the 3270 screen or printer buffer size (defined in the 
DFHTCT TYPE=TERHINAL macro) to be used for this transaction. 

If this operand is not specified, the option indicated in the 
DFHPCT TYPE=INITIAL macro will be used. For further 
information on the choice of screen sizes and buffer sizes, 
refer to the ALTSCRN and DEFSCRN operands in DFHTCT 
TYPE=TERMINAL• 

ALTERNATE 

indicates that transactions will be run in ••alternate” 
screen size mode, using the values from the ALTSCRN operand 
in DFHTCT TYPE=TBRMINAL. SCRNSZE=ALTERNATE may be used for 
all CICS/VS service transactions (for example, CSHT). 

DEFAULT 

indicates that transactions will be run in default screen 
size mode, using the values from the DEFSCRN operand in 
DFHTCT TYPE=TBRMINAL. 

Notes : 

1. If DFHPCT TYPE=ENTRY has SCRNSZE=DEFAULT, and if the DFHTCT 
TYPE-TERHINAL macro contains the ALTSCRN or DEFSCRN 
operands, the transaction will be run in default screen 
size mode, using the erase write (EW) command. That is, 
whenever the terminal issues a terminal output request with 
the ERASE option, the 3270 EW command will be inserted in 
the data stream. The screen size specified in the DEFSCRN 
operand will be assumed, and BUS will use the value 
specified in the PGESIZE operand as the page size. 

2. If DFHPCT TYPE=ENTRY has SCRNSZB=ALTERNATE and DFHTCT 
TYPE=TERMINAL has the ALTSCRN operand, the transaction will 
be run in alternate screen size mode, using the erase write 
alternate (EWA) command. That is, whenever the transaction 
issues a terminal output request with the ERASE option, the 
3270 EWA command will be inserted in the data stream. The 
ALTSCRN value will be assumed as the screen size, and BHS 
will use the value in ALTPGE as the page size. 

3. The SCRNSZB option in DFHPCT TYPE-ENTRY will be ignored if 
the DFHTCT TYPE=TERHINAL macro does not contain either 
ALTSCRN or DEFSCRN. The transaction will then operate with 
the screen sizes and page sizes used by an existing 3270— 
based transaction. That is, the screen size will be 
assumed from the related TRHMODL operand in DFHTCT 
TYPE=TERHINAL, the page size will be taken from PGESIZE, 
and the ALTPGE value will be ignored. The 3270 EW command 
will be inserted for output requests with the ERASE option. 
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SPURGE={NO|YES} 

is used to set the system stall purge indicator* The default 
is SPURGE=NO. 

NO 

indicates that the transaction is not purgeable when a 
system stall condition is detected. 


YES 

' indicates that the transaction is purgeable in a stall 
condition. 


TCLASS={NO I task-class} 

specifies whether a task is to have an associated class. The 
default is TCLASS=NO. 

NO 

indicates that no class is assigned to the task, 
task-class 

indicates a value (from decimal 1 to 10) of the class 
associated with a task. 

Note : The TCLASS parameter for user-supplied transactions that 

have an identification starting with "C' 1 might conflict with 
CXCS/VS-provided transactions. 

TCLASS should not be specified for CICS/VS-supplied 
transactions because their initiation could be inhibited if the 
class threshold was reached. 


TPURGE= {NO | YES} 

is for tasks attached to BTAM terminals only, and is used to 
set the terminal error purge indicator. The default is 
TPURGE=NO. 

NO 

indicates that the task cannot be purged when a terminal 
error occurs. Manual intervention by the master terminal 
operator will be required when this happens. 

YES 

indicates that the task can be purged when a terminal error 
occurs. 


TRANSEC=Q|decimal-value} 

is a decimal value with a range of 1 through 24 that defines 
the transaction security associated with each terminal 
operator. The default is TRANSEC=1 unless the transaction code 
is covered by the TRANSEC operand of the DPHPCT TYPE=INITIAL 
macro, in which case that value is the default. 

Note : When a task is automatically initiated (through 

transient data or interval control) , the operator signed on to 
the terminal must have a security code equal to the transaction 
initiated. To ensure that all automatically initiated tasks 
can be initiated without a security violation, either the 
security code of the transaction should be "I** or the operator 
signed on the terminal must have a maximum security key prior 
to the automatic initiation of a task. 
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In the case of a no—operator terminal, such as a 3284 printer, 
the operator security code defaults to n 1 n ; therefore, any task 
associated with this type of terminal that is to be initiated 
automatically must have a security code of "1«. 


T RN P RT Y = {21 de c ima 1-va lu e } 

is used to define the transaction priority. This one— to 
three-digit decimal value from 0 to 255 is used in establishing 
the overall transaction processing priority. (Transaction 
processing priority is equal to the sum of the terminal 
priority, transaction priority, and operator priority, not to 
exceed 255.) The default is TRNPRTY=1. 


TRNSTAT={ENABLED|DISABLED} 

indicates the transaction status* The default is 
TRNSTAT=ENABLED. 

ENABLED 

allows transactions to be attached normally. 

DISABLED 

indicates that attempts to attach this task will not be 
allowed. 


TWASIZE={0|decimal—value} 

is a one— to five—digit decimal value that determines the size 
(in bytes) of the transaction work area to be acquired for this 
transaction. The default is TWASIZE=0 for user—supplied 
transactions. The requirements of the transactions that are 
supplied by CICS/VS vary, but the minimum TWASIZE required is 
generated, by default, during the expansion of the macro. The 
maximum value that can be specified is 32767 minus the length 
of the task control area (TCA), however, 32000 bytes will 
always be available for the TWA. 


XTRANID=hexadecimal—transaction—identification 

specifies a 4—byte transaction identifier specified in 
hexadecimal notation (the identifier therefore comprises up to 
eight hexadecimal digits). If less than eight hexadecimal 
digits are specified, the identifier will be padded on the 
right with blanks. XTRANID must not begin with X i C3* or end 
with X^FFFFF*. XTRANID provides an alias transaction 
identifier for that specified in the TRANSID and TASKREQ 
operands, and may be used for terminals that use characters 
that are not in the assembler set. If XTRANID is specified, 
INDEX=YES must be specified in DFHPCT TYPE=INITIAL. 


CICS/OS/VS Only 


PRHSIZE=number 

defines the primed storage allocation size. The value 
specified must not exceed 65520 bytes and must include an 
allowance for the primed allocation area (PRA) header (32 
bytes), the TCA (512 bytes), the TWA, and the LIFO storage used 
by CICS/VS nucleus modules* Roughly 1000 bytes must be allowed 
in total for the PRA, the TCA, and LIFO storage. 
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Primed storage retains storage used by a task that has 
completed, and holds it for later use as an initial allocation 
for another task of the same transaction identification. 

Notes; 


1i PRMSIZE=number and ANTICPG=YES or nn cannot be specified 
for the same transaction. Furthermore, primed storage 
allocation cannot be specified for a long—running task 
(CLASS=LONG) . If primed storage allocation is specified, 
the task class will be changed to short. 


2. Storage accounting areas within the primed storage 

allocation are doubleword-aligned (instead of the normal 
double—doubleword—aligned). 


| SPECIAL ENTRIES — DFHPCT TYPE=GROUP 


The optional DFHPCT TYPE=GRODP macro instruction allows the system 
programmer to specify those transaction identifications, which are 
required when certain CICS/VS facilities are used, on a functional 
basis, instead of having to specify the TRANSID=xxxx operands for each 
individual feature being generated in the system. This simplifies the 
task of specifying the required entries for the CICS/VS—supplied 
transaction names. For example, DFHPCT TYPE=GROUP,FN=ATP provides the 
required entries previously supplied by specifying: 

• DFHPCT TYPE=ENTRY,TRANSID=CAQP 

• DFHPCT TYPE=ENTRY,TRANSID=CATP 

• DFHPCT TYPE=ENTRY,TRANSID=CRDR 

• DFHPCT TYPE=ENTRY,TRANSID=CWTR 

The user should refer to the PCT section of Appendix A for more 

| detailed information on the special identifiers. Pre—defined entries in 
a GROUP macro (for example, security codes) may be overridden in a 
DFHPCT TYPB=ENTRY macro coded before the GROUP macro* Otherwise, GROUP 
and ENTRY macros can be mixed in any order. The ■•groupable 11 entries 
will not be generated twice in an assemblyi 


| |DFHPCT | TYPE=GROUP 

I I ) , FN= (functionf ,...]**.) 

|| | | [ ,EXTSEC={NO|YES} } 

|| | | [ ,KEYID=PA—or—PF—key] 

i_i-1- 


I 

I 

I 

I 


TYPE=GROUP 

| indicates that required entries in the PCT will be generated to 

| support the named functions. 


| FN= (function[ ,...]) 

indicates the generic function name that generates the entries 
required in the PCT for the associated facility. Any numner of 
options from the list below can be specified in one DFHPCT 
TYPE=GROUP macro. The options are: 
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AKP 


generates TRANSID=CSKP for the activity keypoint program. 

ATP 

provides the transaction identifications associated with 
the asynchronous transaction processing facility. The 
transaction identifications generated are: 


• CAQP — asynchronous purge gueue 

• CATP — asynchronous transaction control program 

• CRDR — ATP input processor 

• CWTR — ATP output processor 


AUTOSTAT 

generates TRANSID=CAUT for the automatic statistics 
summarization utility. 


BMS 

generates the following identifications for transactions 
running under BMS: 


• CSPG — terminal page retrieval 

• CSPQ — terminal page clean—up 

• CSPS — delayed message delivery 

See also the KEYID operand, below. 

CONSOLE 

generates TRANSID=CWTO for processing unit console support 
in CICS/DOS/VS, and generates TRANSID=CSCE in CICS/OS/VS 
for console support abnormal conditions. 

EDF 

provides transaction CEDE for the execution (command level) 
diagnostic facility (EDF) . See also the KEYID operand, 
below, and the TRANSEC operand in DFHPCT TYPE=INITIAL. The 
default RSLC value for this transaction is YES. 

FE 

generates TRANSID=CSFE for the FE terminal test facility 
and transaction CSFR (for CICS/DOS/VS and BTAtt only) for 
the facility error recognition system (FERS). See also the 
TRANSEC operand in DFHPCT TYPB=INITIAL• 

INTERPRETER 

generates TRANSID=CECI and CECS for the command 
interpreter. The default RSLC value for these transactions 
is YES. 

HARDCOPY 

generates TRANSID=CSPP for the 3270 print support function 
(BTAM and VTAM) . 
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ISC 


generates the following transaction identifications for 
CICS/VS intercommunication support and DL/I shared data 
base support in CICS/OS/YS: 


• CHTB — routing transaction 

• CSMI — mirror transaction 

• CSNC — IRC connection manager 

• CRSR — remote scheduler transaction 

• CSIR — IRC session recovery transaction 

• CRSQ — ATI Purge transaction 

• CMPX — local queuing shipper 

The default RSLC value for the mirror transaction (CSMI) is 
YES. 

JOURNAL 

generates TRANSID=CSJC for the journal tasks bootstrap 
program, and is required if journal management is being 
used. 

MASTTBRM 

provides the following transaction identifications for the 
master terminal facility. See also the TRANSEC operand in 
DPHPCT TYPE=INITIAL: 


• CSMT — master terminal functions 

« CSST — supervisor terminal functions 

• CSOT — terminal operator functions 


MSWITCH 

generates TRANSID=CMSG for the message switching program. 
Note that the user may choose any four-character code to 
replace CMSG. FN=MSWITCH also generates the BMS group of 
transaction identifications. 

NUMERICS 

generates TRANSID=8888 and 9999 for numeric-only devices, 
such as the 7770, as the sign-off and sign-on transaction 
identifications. 

OPERATORS 

generates TRANSID^CBMT, CEST* and CEOT for the enhanced 
master terminal, supervisor, and terminal operator 
functions. See also the TRANSEC operand in DFHPCT 
TYPE^INITIAL. 

RESEND 

generates TRANSID=CSRS for the resend program <VTAM only). 
RESPLOG 

generates TRANSID=CSLG for the response logging program 
(VTAfl only) . 

SIGNON 

generates the transaction identifications associated with 
the sign—on program. The transaction identifications 
generated are: 


• CSSN — sign-on 

• CSSF — sign-off 
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STANDARD 

provides the transaction identifications that are required 
| in all CICS/VS systems. The transaction identifications 

generated are: 


| • CCMF — monitoring control program 

• CSTT — supervisor statistics program 

• CSAC — abnormal condition program 

• CSTE — terminal abnormal condition program 


TIME 

generates TRANSID=CSTA for the time—of—day adjustment 
program. 

VTAM 

generates TRANSID=CSNE for the VTAM node abnormal condition 
program and CSGM for the good morning sign-on message. 

VTAMPRT 

provides the following transaction identifications 
associated with the VTAM 3270 print function: CSCY, CSPK, 
and CSRK. 


| EXTSEC= {NO | YES} 

| overrides the default setting for the EXTSEC operand in DFHPCT 

| TYPE=INITIAL, for those members of the group that are allowed 

| to be checked by external security. 


| KEYID=PA—or—PF—key 

| allows the transactions from the FN=BMS and EDF groups to be 

| initiated by pressing a predefined PA or PF key. Any PA or PF 

| key (or a number of these keys) can be defined for FN=BMS; only 

| one PF key (selected oj the user) can be used for FN=BDF. 


TRANSACTION DESCRIPTION OPTIONS — DFHPCT TYPE=OPTGRP 


The DFHPCT TYPE=OPTGRP macro instruction is used to control message 
protection processing for a task executing on a VTAM-supported TCTTE. 
The parameters specified cause CICS/VS to log relevant data about the 
transactions terminal data during processing, and are also used for 
| message resynchronization if a failure occurs* 


| name JDFHPCT | TYPE=OPTGRP 

| | | [ ,MSGPOPT= ([ CCONTRL ][ ,MSGINTEG ][ ,ONEWTE ][ ,PROTECT ]) ] 

| | | [ ,MSGPREQ= ([ CCONTRL ][ ,MSGINTBG ][ ,ONEWTB ][ ,PROTECT ]) ] 

i-1_«_ 


name 

specifies the name of the message option group. This operand 
is required and can be any valid assembler—language name, from 
one to six characters* This is the same name that is specified 
in the OPTGRP=name parameter of the DFHPCT TYPB=ENTRY macro 
instruction. 
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TYPB=OPTGRP 

generates a transaction option group macro* 

MSGPOPT- ([CCONTRL][ , MSGINTEG ][ ,ONEWTE[ ],PROTECT ]) 

| defines the optional facilities the task can use. 


CCONTRL 

specifies that the application program can control the 
outbound chaining of request units. If this option is 
specified, the PROTECT option must not be specified. Also, 
if CCONTRL is specified, ONEWTE means one chain, and not 
one terminal control output request. 

I Note ; BBS output requests may correspond to terminal 

| control write operations. 

MSGINTEG 

specifies that a definite response is to be requested with 
an output request to a logical unit communicating with this 
task. This option must not be specified for a PIPELINE 
transaction. {See DFHTCT TYPE=TERMINAL later in this 
chapter.) 

ONEWTE 

specifies that the transaction is only permitted one DFHTC 
TYPE=WRITE during its execution* Any additional write 
requests are treated as errors, and the task is readied for 
abnormal termination. BRACKET=YES must be specified in the 
DFHTCT TYPE=TERMINAL macro for logical units* The ONEWTE 
option must be specified for a PIPELINE transaction. 

PROTECT 

specifies a protected task* This option provides message 
integrity (see the MSGINTEG option). It also causes 
message logging to take place. Also, CICS/VS will record 
the contents of deferred write requests that are pending at 
a sync point, and record the receipt of the definite 
response associated with the deferred write on the system 
log for message recovery and resynchronization purposes. 
Journaling support is required during generation of the 
CICS/VS system. The PROTECT option must not be specified 
for a PIPELINE transaction* specifies which options the 
task can use. 

For tasks using 3600 logical units, MSGPREQ and MSGPOPT provide 
the same function; that is, any option (whether specified by 
MSGPREQ or MSGPOPT) can be invoked by the task. 


| MSGPREQ=([CCONTRL][ ,MSGINTEG ][ ,ONEWTE ][ ,PROTECT]) 

| defines the required processing options and characteristics 

| that the terminal entry must support in order to run a task. 

The options are the same as for the MSGPOPT operand. 
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SESSION PROCESSING OPTIONS — DPHPCT TYPE=PROFILE 


The DFHPCT TYPE=PROFILE macro defines the set of terminal control 
processing options that are to be used during the execution of terminal 
control requests for an LUTYPE6 session. 


i-1-1 



IDFHPCT 

1 

TTPE=PROFILE 



1 

1 

,PROFILE=name 



1 

1 

[ ,EXTRACT 3 {NO| (ATTACH)} ] 



1 

1 

[,INBFMH={ALL|HO}] 



1 

I 

r.JFILEID=fMOISYSTEM Inn) ] 



1 

1 

[ ,MSGJRNL= ([ INPOT][ ,OOTPOT ]) } 



1 

1 

[,NEPCIAS=0|integer] 



i-1-a_i 


TYPE=PROFILE 

indicates that session processing options are to be specified 
for an LUTYPE6 session. 


PROFILE=name 

indicates that the processing options specified in this macro 
will be used for the session with the corresponding PROFILE 
name in the EXEC CICS ALLOCATE request. 


EXTRACT= {NO | (ATTACH) } 

specifies whether function management headers are to be removed 
from input data. The default is EXTRACT=NO. 

NO 

specifies that no function management headers are to be 
removed from input data during command level processing of 
RECEIVE and CONVERSE commands. 

(ATTACH) 

specifies that the type 6 logical unit attach function 
management headers are to be removed from input data during 
command level processing of RECEIVE and CONVERSE commands. 

The EXTRACT operand has no effect for macro level programs 
or when no function management headers are to be passed to 
the application program. That is, specification of 
INBFMH=NO overrides the EXTRACT operand. 


INBFMH= (ALL| NO} 

specifies whether a user function management header (FMH) 
received from the L0TYPE6 logical unit is to be passed to the 
application program # s TIOA. 

ALL 

indicates that all FMHs (except LUTYPE6 ATTACH and 
SYNCPOINT FMHs which are processed by CICS/VS) are passed 
to the application program. This operand is required for 
transactions that use Distributed Transaction Processing. 


NO 

indicates that the FMHs are to be discarded. 
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JFILEID={NOJSySTEM|nn} 

specifies where records generated during automatic journaling 
are to be stored* The default is NO. 


NO 

indicates that no automatic journaling of messages is to 
take place. 

SYSTEM 

indicates that automatic journaling for logical units is to 
be performed on the system log when this transaction is 
executing. 

nn 

indicates the journal ID to be used for automatic 
journaling. This may be any value from 2 through 99. 


Note: If automatic journaling is specified, the journal 

control program and journal control table parameters must be 
specified to support the TCP automatic journaling requests. 


MSGJRNL= ([ INPOT ][ , OUTPUT ]) 

indicates whether automatic journaling is to be performed. If 
this operand is specified, JFILEID is also required. 

INPUT 

indicates that journaling is required for input messages. 
OUTPUT 

indicates that journaling is to be performed for output 
messages. 

Either or both INPUT and OUTPUT can be specified. If both are 
specified, they must be in parentheses. 


NEPCLAS={0|integer} 

defines the class of the transaction for the node error program 
module (DFHZNEP)• Integer is a value between 0 and 255; note 
that specifying 0, or a value greater than 255, will result in 
a subsequent link to the default transaction class routine (see 
'■User-Written Node Error Programs'* in Chapter 4.3) . The 
default value is 0. The identifying integer is placed in the 
PCT for reference by the DFHZNEPI TYPE=ENTRY macro instruction. 


REMOTE TRANSACTIONS — DFHPCT TYPE^RBMOTE 


The DFHPCT TYPE=REMOTE macro defines the transactions that are to be 
executed in a remote system or region when CICS/VS intercommunication 
| facilities are used. With the exception of the RMTNAMB, SYSIDNT, and 
j LOCALQ operands, the details for the TYPE=REMOTE operands are as 
I described in the TYPE=ENTRY macro. None of the optional operands are 
| required for function request shipping of an EXEC CICS START command for 
| the transaction. 
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r 

t 

i ~ ■ . 

- ( 

i 

|DFHPCT 

| TYPE=REMOTE 


i 

i 

| ,RMTNAME=name 


i 

i 

| ,SYSIDNT=name 


i 

i 

| ,TASKRBQ=XXXX 


i 

i 

| ,TRANSID=transaction—identification 


i i 

i 

1 r.CLASS=(LONG 1 SHORT} 1 


i 

i 

| [ ,DTB={NO|YES| (TBS,HO) | (YES,WAIT)} ] 


i 

i 

| [,DTIMOUT={NO|numeric—value}] 


i 

i 

| r »DVSUPRT= CALL 1 HOHV1VTAM) 1 


! 1 

i 

| [,EXTSBC={NO|YES}} 


1 1 

i 

I [,FDUMP={(ASRA,ASRB)|ASRA|ASRB}] 


1 

i 

| [,JFILEID= {NO|SYSTEM|nn} } 


1 1 

i 

| [,LOCALQ={NO|YES}] 


1 

i 

| [,LOGREC={NO|YBS}] 


1 

i 

| [ ,MSGJRNL=([ INPOT],[OUTPUT]) ] 


1 

i 

| [ ,NEPCLAS=0|integer] 


1 

i 

| [,OPTGRP=naae] 


1 1 

i 

| [ ,PRIVATE= {NO | YES} ] 


1 1 

i 

| [,RAQ={0|number}] 


1 

i 

| [ ,RBSTART={NO|YES} ] 


1 1 

i 

| [,RSLC= {NO|YBS} ] 


1 

i 

| [,RSL={0|number}] 


1 

i 

| [,RTIMOOT={NO|numeric—value} } 


1 

i 

1 r,SCRNSZE=(DEFAULT 1 ALTERNATE)1 


1 

i 

| [,SPDRGE={HO|YES}] 


1 

i 

| [,TCIASS={HO|task-class}] 


1 

i 

| [ ,TPURGB={NO|YES} ] 


1 

i 

| [,TRANSEC={11 decimal-value}] 


1 

i 

| C,TRNPRTY=Q|decimal-value}] 


1 

i 

1 T.TRNSTAT=fEHABLED1 DISABLED) 1 


1 1 

i 

| [,TWASIZE={0|decimal—value} ] 


1 

1 

i 

•_ 

| [ ,XTRANID=hexadecimal—transaction—identification] 

_i_ 

_1 


TYPE=REMOTE 

indicates that the transaction resides in a remote system or 
region. 


RHTNAHE=name 

indicates the one— to four-character alphanumeric name by which 
the transaction is known in the remote system or region when 
CICS/VS intercommunication facilities are being used. The name 
by which the transaction is known in the local system or region 
is given in the TRANSID operand* If the RMTNAME operand is 
omitted, the transaction name from the TRANSID operand will be 
used. Note that the transaction need not necessarily reside on 
the remote system or region. 


SISIDNT^name 

specifies the one— to four—character alphanumeric name of the 
system or region to which this PCT entry points and must be 
specified when CICS/VS intercommunication facilities are being 
used. The name provided must be the same as that in the 
SYSIDNT operand of a DFHTCT TYPE=SYSTEM macro, unless it is 
specified in an explicit remote request in an application 
program. 


| LOCALQ= {NO | YES} 

| specifies whether local queuing is to be performed. The 

| default is LOCALQ=NO. 


Chapter 3.2. Table Preparation 


183 







NO 

specifies that no local queuing is to be performed. 

YES 

specifies that local queuing can be attempted for an EXEC 
START NOCHECK request when the system is not available and 
the system name is valid. A system is defined as not 
available when: 


| • the system is ‘OUT OF SERVICE 1 when the request 

| is initiated. 

| • the attempt to intiate any session to the remote 

| system fails and the corrective action taken by the 

| abnormal condition program (DFHZNAC) or the node 

| error program (DFHZNEP) is to place the system 

| •ODT OF SERVICE *. 

I Note s: 

| Local queuing should be used only for those EXEC START 

| commands which represent time independent requests. The 

| delay implied by local queuing will affect the time at 

| which the request is actually started. It is the user's 

| responsibility to ensure that this condition is met. 

| 2. The effect of the LOCALQ operand may be overridden by use 

| of the user exit (XISLCLQ) in module DFHISP. 

Note : All operands that can be specified on a DFHPCT TYPE=ENTRY macro 

instruction may be specified on a DFHPCT TYPE=REMOTE macro instruction. 

| However, the following operands will be treated differently if specified 
| on TYPE=REMOTE: 

| PROGRAM is forced to PROGRAM=DFHCRP 

| INBFMH is forced to INBFMH=ALL 

| PRMSIZE is ignored 

| ANTICPG is forced to ANTICPG=NO 

| COMPAT is ignored 

| DUMP is forced to DUMP=YES 

| The TWASIZE required by the relay program DFHCRP is zero. Therefore, 
j TWASIZE should be specified as zero unless a system requirement demands 
j otherwise. 

The operands specified on a DFHPCT TYPE=REMOTE macro instruction 
apply to the transaction that executes in the terminal—owning system 
when a transaction is routed to another system. The properties of the 
transaction that runs on the remote system are derived from the PCT 
entry for the transaction in that system. 

| If the remote transaction is only invoked by means of an EXEC CICS 
| START command, and never by terminal input or ATI to a remotely owned 
| terminal, then the only operands that are relevant are 
| RMTNAME,SYSIDNT,TRANSID, and RSL. 
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END OF PROGRAM CONTROL TABLE — DFHPCT TYPE=FINAL 


The end of the program control table is indicated by the DFHPCT 
TYPB=FINAL macro instruction, which is the last statement in the 
assembly of the program control table before the assembler END 
statement. This macro instruction creates a dummy entry to signal the 
end of the table. 

i-1-1---1 

| IDFHPCT | TYPE=FINAL | 

i-1-1_i 


TYPE=FINAL 

indicates the end of the program control table. 


EXAMPLES 


| Figure 3.2—11 illustrates the coding that is reguired to create a 
program control table. The transactions include: 

• Three transactions of a higher priority than the default priority 
(TRNPRTY=1 is the default) 

• Two transactions with security key protection 

• Total of nine transactions 

Refer to the FN=STANDARD option of the DFHPCT TYPE=GROUP macro for a 
list of all the entries reguired wnen creating a program control table. 
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DFHPCT TYPE=INITIAL, SHALL TABLE, SO HO INDEX. * 

SUFFIX=01, * 

TRANSEC* (HASTES (12),SOPERVISOR (11)) 

DFBPCT TYPS=ENTRY, * 

TRA N SID=KOB1, * 

TWASIZB=64, * 

PROGRAH=KOBPGH1 

DFHPCT TYPE=ENTBY, * 

TRANSID=KOB2, * 

TBNPBTY=100, * 

TRANSEC=10, * 

PBOGRAH=KOBPGH2 

DFHPCT TYPE=ENTRY, * 

TBANSID=KOB3, * 

TWASIZE=100, * 

TBANSEC=5, * 

PROGRAM=KOBPGH3, * 

TPOBGE=YES 

DFHPCT TYPE=ENTRY, * 

TBANSID=KOB4, * 

PROGBAH=KOBPGH4, * 

BTIMOOT=515, HOST RESPOND WITHIN 5-1/4 HINOTBS * 

TPOBGB=YES 

DFHPCT TYPE=GBOOP, HASTER AND SOPEBTISORY TEBHINAL * 

FN=OPERATORS SUPPORT. 

DFHPCT TYPE=ENTRY, * 

TRANSID=CSSF, INSIST ON HIGH PRIORITY FOR SIGN-OFF* 

TRNPRTY=150, IN THIS SYSTEH. * 

PROGRAH=DFHSNP 

DFHPCT TYPE=GROOP, * 

FN=SIGNON 

DFHPCT TYPE=GROOP, * 

FN=STANDARD 

DFHPCT TYPE=GROOP, * 

FN=TIHE 

DFHPCT TYPE=FINAL 

END 

| Figure 3.2—11 (Part 1 of 4). Program Control Table — Example 1 


186 


CICS/VS System Programmer's Reference Hanual 




| DFHPCT TYPE=INITIAL,SUFFIX=02, * 

| INDEX^YES, INDEX NEEDED TO SUPPORT MULTIPLE * 

| TRANSEC= (BDF (6),MASTER (24) ) TRANSACTION IDENTIFIERS 

| GROUP1 DFHPCT TYPE^OPTGRP, * 

| MSGPREQ=ONEWTB 

| GROUP2 DFHPCT TYPE=OPTGRP, * 

| MSGPREQ= (ONEWTE ,MSGINTEG) 

| GROUP3 DFHPCT TYPE^OPTGRP, * 

| MSGPOPT=PROTECT 

| DFHPCT TYPE=ENTRY, * 

| TRANSID=TRNA, * 

| PROGRAM=PROGRA, * 

| DVSUPRT=NONV 

| DFHPCT TYPB=ENTRY, * 

| TRANSID-TRNB, * 

| PROGRAM=PROGB, * 

| PRMSIZE=1000, * 

| OPTGRP=GROUP2, * 

| DVSUPRT^FTAM 

| DFHPCT TYPE=£NTRY, * 

| TRANSID=TRNC, * 

| PROGRAM=PROGC, * 

| OPTGRP=GROUPl 

| DFHPCT TYPE=BNTRY, * 

| TRANSID=TRND, * 

| PROGRAM=PROGD, * 

| OPTGRP-GRO UP3 

| DFHPCT TYPE=ENTRY,TASKREQ=PA3,PROGRAM=TTC33,TWASIZE=550, * 

| SPURGE=YES , TPURGE=YES ,TRNPRTY=10, TRANSID=PA3 

| DFHPCT TYPE=BNTRY,TASKRBQ=OPID,PROGRAM=BADGE,TRNPRTY=5, * 

| SPURGB=YBS 

| DFHPCT TYPB=ENTRY # TASKRBQ=PF20,PROGRAM=TTC8A r TWASIZE=550,TRNPRTY=10 # * 
| SPUR GE =YBS,TPURGB=Y BS,TRANSID=F20 

| DFHPCT TYPE=GROUP, * 

| FN=SIGNON 

| DFHPCT TYPE=GROUP, * 

| FN=OPERATORS 

| DFHPCT TYPE-GROUP, * 

| FN=EDF 

| DFHPCT TYPE=GROUP, * 

| FN= (RBSPLOG,VTAM) 

| DFHPCT TYPE=GROUP r * 

| FN=STANDARD 

| DFHPCT TYPE=FINAL 

| END 

| Figure 3.2—11 (Part 2 of 4). Program Control Table — Example 2 
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* THIS DEMONSTRATES A DFHPCT HITS REMOTE ENTRIES, 

* AS NEEDED TO SUPPORT TERMINAL SHARING« 

DFHPCT TYPE-INITIAL,INDEX=YES,SCRNSZE=ALTERNATB,SUFFIX=03 

* 

DFHPCT TYPE=RBMOTB,TASKREQ=PA3,SYSIDNT=ZULU,XTRANID=F3F3F3 
DFHPCT TYPE=GROUP,FN=ISC EVERYTHING TO OPERATE THE LINK. 

DFHPCT TYPE=REMOTE,TRANSID=FAR,RMTNAME=AWAY,5YSIDNT=Y 
DFHPCT TYPE=REMOTE,TRANSID=THIS,SYSIDNT=ZULU,FDUMP=ASRA 
DFHPCT TYPE=REMOTE,TRANSID=TTHR,SYSIDNT==ZULU 
DFHPCT TYPE=REMOTE,TfiANSID=AWA,SY SIDNT=ZU LU 

DFHPCT TYPE=ENTRY,TASKREQ=PFl,PROGRAM=BADGE,TRNPRTY=5, * 

TRANSID=FN1, * 

SPURGE=YES,FDUMP=ASRA 

DFHPCT TYPE=RSMOTE,TASKREQ=OPID,RMTNAME=DIPO,SYSIDNT=ZULU 

DFHPCT TYPE=GROUP,FN=SIGNON 

DFHPCT TYPE=GROUP,FN=STANDARD 

DFHPCT TYPE=FINAL 

END 

Figure 3.2—11 (Part 3 of 4). Program Control Table — Example 3 


| DFHPCT TYPE=INITIAL,SUFFIX=04,INDSX=YES,FDUMP=ASRA 

I * 

| DFHPCT TYPE=REMOTB,TRANSID=MROA,SYSIDNT=AWAY,SPURGE=YES 

| DFHPCT TYPE=ENTRY,PROGRAM=TMROW,TRANSID=MR03,TRANSEC=2 

| * 

| * MASTER TERMINAL CAN BE USED FOR REMOTE SYSTEMS FROM THIS ONE: 

I * 

| DFHPCT TYPE=REMOTE,TRANSID=2SMT,RMTNAME=CSMT,SYSIDNT=AWAY 

| DFHPCT TYPE=RBMOTB,TRANSID=2EMT,RMTNAME=CEMT,SYSIDNT=AWAY 

| * 

| DFHPCT TYPE=REMOTE,TRANSID=MR10,SYSIDNT=AWAY, * 

| RTIMOUT=015,DTIMOUT=010 SHORT TIME-OUTS 

I * 

| * CREATE ENTRIES FOR PA AND PF KEYS SO THAT BMS SKR CAN BE USED 
I * 

| DFHPCT TYPE=ENTRY,TASKREQ=PA1,PROGRAM=DFHTPR,TWASIZE=800 

| DFHPCT TYPE=ENTRY,TASKREQ=PF2,PROGRAM=DFflTPR,TWASIZE=800 

I * 

| DFHPCT TYPE=REMOTE,TWASIZE=40,TRANSID=AMNU,SYSIDNT=AWAY 

| DFHPCT TYPE=GROUP,FN=(BMS,STANDARD) 

| DFHPCT TYPE=FINAL 

| END 

| Figure 3.2—11 (Part 4 of 4). Program Control Table — Example 4 


PLT — PROGRAM LIST TABLE 


The program list table is a list of a logically related group of 
programs that has two uses. The first is to define a list of programs 
to be executed prior to the terminal control program receiving control 
after system initialization processing, or a list of programs to be 
executed during system termination. 

| The second use is to define a logically related group of programs 
that are to be disabled or enabled through the master terminal. The 
tables are differentiated by means of the suffix parameter. 

| There must be an entry in the processing program table (PPT) for each 
| program to be used. 
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When writing PLT programs, the following factors concerning PLT 
programs executed during system initialization must be considered: 

• The programs cannot communicate with terminals, because the TCA of 
the terminal control program is used during execution of all PLT 
programs* 

| • Programs that are initiated from the PLT can not use the TCP*s TCA. 

• The programs must not request any service that could logically 
suspend the task* Suspending the TCA of the terminal control 
program will cause the system to be terminated abnormally. Post- 
initialization phase programs must not depend on transactions being 

| initiated by interval control, because no interval control 

| initiations occur until the post—initialization phase has 

| completed. 

The program must never change the priority of the task executing 
the PLT program, because the task is TCP and it must remain as the 
highest priority task. Even if "chapped 11 to itself (X^F 1 ), it 
could become lower in priority than other X*FF* priority tasks 
already attached. 

• Although attaching of other tasks during PLT processing is 
supported, they must not access a protected resource that is also 
being accessed by the TCP task that is executing PLT programs. 

Task control 2NQ/DEQ facilities can be used in the PLT programs 
executed by the TCP task and other programs executed by the 
attached programs to ensure single threading of the use of 
protected resources. However, it is the user*s responsibility to 
ensure that the TCP task always enqueues first. (If TCP attempts 
an ENQ and fails to gain control of the resource, it will be 
suspended and will cause CICS/VS to abend.) Because concurrent 
accessing of protected resources is difficult to control, it is 
recommended that the resources be serialized, and that no task is 
attached to access the resource until the TCP task executing the 
PLT program has completed its processing. 

• Because standard CICS/VS services are available to PLT programs, it 
is important to understand and consider the effect of these 
services when they involve accessing protected resources as defined 
to CICS/VS. 

When a protected resource is accessed, CICS/VS normally enqueues on 
the resource to ensure exclusive ownership, during the task*s use 
of the resource. The actual dequeuing of a protected resource is 
deferred until the task terminates or voluntarily declares itself 
| to be at a “sync" point (through the EXEC CICS SYNCPOINT command). 

PLT programs that are involved in rebuilding a protected file 
control data base will cause an enqueue to occur for each logical 
record they access. Because the dequeues are deferred, it is 
advisable for the user to declare "sync" points throughout the 
recovery process to allow dequeues to occur* If this procedure is 
not followed, dynamic storage can become filled with CICS/VS 
control blocks used to control the enqueue/dequeue facility. In 
addition, no other task should be attached that could also access 
records in the data base until after the PLT program has completed 
its entire rebuilding operation. Enqueuing on the data base by 
both tasks will not keep the attached task from gaining control of 
the data base when the PLT processing task declares a "sync” point. 
This is because of tne implicit dequeuing that occurs at that time. 

The termination programs defined in DFHPLTxx operate in one of two 
time—dependent environments: the first quiesce stage and the second 
quiesce stage. 
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During the first stage, the programs defined to run in that stage 
execute. Terminals are still available, but only those transactions 
defined in the transaction list table may be initiated from them. 
Existing tasks, automatically—initiated tasks, or ATP batch jobs in 
process are allowed to continue to their normal conclusion. 

The second quiesce stage begins at the point in the program list 
table defined by DFHPLT TYPE=ENTRY,PROGRAM=DFHDELIM. Termination 
activity waits until all first quiesce stage system activity stops. 
Termination then continues with the TCP and task control ATTACH 
disabled, and, when all DFHPLT programs defined to execute in the second 
quiesce stage have been completed, CICS/VS terminates further execution. 


CONTROL SECTION — DFHPLT TYPB=INITIAL 


The DFHPLT TYPE=INITIAL macro instruction generates the program list 
table control section. 


* I 

* I 


| * See the first page of this chapter. 


| | |DFHPLT | TYPE=INITIAL 

|| | | [,SUFFIX=XX] 


ENTRIES IN PROGRAM LIST TABLE — DFHPLT TYPE=ENTRY 


Entries are specified in the program list table as follows. Note that 
an entry for each program list table generated must be included in the 
processing program table (DFHPPT)* 


I 

I 

L 


I-f- 1 

(DFHPLT | TYPE=ENTRY 

| I , PROGRAM^ (program[ , program M i.]) 


L 


1 


I 

I 


J 


TYPB=ENTRY 

specifies that one or more entries are to be generated in this 
table. 


PROGRAM=program name 

specifies a program name of up to eight characters* An entry 
in the PPT is required for each program named. 


r 

I 

I 

L 


r 


r 


(DFHPLT | TYPE=ENTRY 
| | ,PROGRAM=DFHDELIM 

.1_i___ 
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PE OGB AM=D FHDE LIM 

is used with programs to be executed during system termination. 
Following the specification of any programs that are to be 
executed during the first quiesce stage, the DFHPLT TYPE=ENTRY, 
PROGRAM=DFHDELIM entry delimits the first guiesce stage 
programs in the table. The specification of any programs to be 
executed during the second quiesce stage follows this entry. 
Note that the second stage programs are not allowed to use any 
terminal control services or task control ATTACH requests. No 
automatically-initiated transaction can be initiated during the 
second guiesce stage* 


r 

I 

I 

L 


r 


| DFHPLT | TYPE=ENTRY 
| | ,PROGRAM=DLZSTPOO 

»- 1 _ 


(CICS/DOS/VS only) | 

I 


PROGRAM=DLZSTPOO 

| is used to quiesce the DL/I VSE online system* Upon receiving 

control, this program verifies that there are no active DL/I 
tasks, and then closes the DL/I data base log and DL/I data 
bases. After execution of this program, all reguests for DL/I 
services are ignored. 


END OF PROGRAM LIST TABLE — DFHPLT TYPE=FINAL 


The DFHPLT TYPE^FINAL macro instruction specifies the end of the program 
list table* The assembler END statement must follow. 

i-,- 1 -*---1 

| IDFHPLT | TYPE=FINAL | 

i-1-1-1-» 


TYPE=FINAL 

indicates the end of the program list table* 


EXAMPLE 


I Figure 3.2—12 illustrates the coding required to generate a program list 
table. 
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* 


DFHPLT 


DFHPLT 

DFHPLT 

DFHPLT 


TYPE-INITIAL, LIST OF PROGRAMS TO BE * 

SUFFIX=TM EXECUTED SEQUENTIALLY 

DURING SYSTEM TERMINATION 
EXECUTED DURING 1st QUIESCE PHASE 
TYPE=ENTRY,PROGRAM=TRAEA (PROGRAMS MUST ALSO BE 
TYPE=ENTRY,PROGRAM=TRARB ENTERED IN THE PPT) 
TYPE=ENTRY,PROGRAM=TRARC 


* 

* 


DFHPLT TYPfi=BNTRY,PROGRAM=DFHDELIM 

EXECUTED DURING SECOND 
QUIESCE PHASE: 

DFHPLT TYPE=ENTRY,PROGRAM=TRAFA 
DFHPLT TYPE=ENTRY ,PROGRAM=TRAFB 
DFHPLT TYPE=FINAL 


* 


DFHPLT TYPE=INITIAL, 

SUFFIX=IN 

DFHPLT TYPE=2NTRY,PROGRAM=TRASA 
DFHPLT TYPE=ENTRY,PROGRAM=TRASB 
DFHPLT TYPE=ENTRY,PROGRAM=TRASC 
DFHPLT TYPE=FINAL 
END 


LIST OF PROGRAMS TO BE 
EXECUTED SEQUENTIALLY 
DURING SYSTEM INITIALIZATION 
(PROGRAMS MUST ALSO BE 
ENTERED IN THE PPT) 


| Figure 3.2-12. Program List Table — Example 


PPT — PROCESSING PROGRAM TABLE 


The processing program table allows the user to describe to program 
control the control information for all user-written and CICS/VS— 
supplied application programs and maps. In addition, program control 
uses portions of each table entry to retain certain information for 
| maintaining control of the user f s programs and to capture program 
| statistics. 

This table is required by CICS/VS to verify the processing program 
identification, to keep count of the number of tasks using that program, 
to maintain the address of the processing program, to maintain the 
direct access address and size of the program, and to maintain 
statistics on the processing program. 

The programs that are used most often during execution of CICS/VS 
should be specified first during preparation of the processing program 
table. 


CONTROL SECTION — DFHPPT TYPE=INITIAL 


The control section into which the processing program table is assembled 
is established by the DFHPPT TYPE=INITIAL macro instruction, which must 
| be coded as the first statement in the source. 


i-1-1- 

| | |DFHPPT | TYPE=INITIAL 

I I I [,1NDEX={NO|YES)] 

|| | | [,SUFFIX=xx] 

I_I_> - . -r- ■ 


| * See the first page of this chapter. 


-! 

* I 
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INDEX = {NO |YES} 

specifies whether indexing is to be used* The default is NO. 
NO 

indicates that indexing will not be used*^ 

YES 

indicates that indexing will be used. SJhen this option is 
specified, an alphabetically ordered list of transaction 
names is generated as part of the expansion of the DFHPPT 
TYPE=FINAL macro. 

In some circumstances, indexing reduces the average time 
required to search CICS/VS tables by shortening the scan to 
locate entries* It also reduces the CICS/VS working set for 
large tables by reducing references to little-used or unused 
pages. Refer to the appropriate CICS/VS System Programmer^ 
Guid e for a discussion on performance considerations involving 
indexing. 


PROCESSING PROGRAMS - DFHPPT TYPE=ENTRY 


A specific processing program is described to CICS/VS program management 
services by the DFHPPT TYPE=ENTRY macro instruction. Included is 
information on the program name and the type of program. 



IDPHPPT 

1 

TYPB=SNTRY 



\ 

1 

,PROGRAM=nams 



I 

1 

r »P.GMLANG= {ASSEMBLER ICOBOLIPL/IIRPG} 1 . 



1 

1 

r.PGMSTAT={ENABLEDIDISABLED!1 



1 

1 

[ ,RELOAD={HO| YES} ] 



1 

1 

[,RES={HO|ALIGN|FIX|PGOUTjYES} ] 



1 

1 

[,RSL={0|number] 



1 

1 

[,USAGE=MAP] 



TYPE=BNTRY 

specifies that an entry is to be generated in this table. 


PROGRAM=name 

specifies the program or map identification, up to eight 
characters in length* The indicated program must be link- 
edited before this table is used* 

Note ; For a BMS device—dependent mapset, the program name must 
be derived by appending the mapset suffix to the original one— 
to seven—character mapset name. The suffix depends on the 
parameter specified in the TERM operand of the DFHMSD macro 
instruction that defined the mapset. For further information 
on mapset suffixes, refer to the C ICS/VS Application 
Programmer*s Reference Manual (Macro Level) . 


PGMLANG= f ASSEMBLER I COBOL|PL/I|RPG} 

specifies the program language. The default is 
PGMLANG=ASSEMBLER. 

ASSEMBLER 

indicates an assembler—language program 
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COBOL 

indicates an ANS COBOL program 

PL/I 

indicates a PL/I program. This option may also be written 
as PLI, PL/1, or PL1. 

RPG 

indicates an RPG II program (CICS/DOS/VS only). RELOAD=YES 
must also be specified* 

This parameter must be omitted when preparing PPT entries for BMS maps. 
PGMSTAT=f ENABLED I DISABLED) 

specifies the program status* The default is PGMSTAT=ENABLED• 
ENAB LED 

indicates that this program may be used in a normal manner. 
DISABLED 

indicates that usage of this program will not be allowed. 


RELOAD= {NO | YES} 

specifies whether a load request brings in a fresh copy of a 

program. The default is RBLOAD=NO• 

NO 

indicates that a load request is ignored if the program is 
currently in storage* 

YES 

indicates that a fresh copy of the program is to be loaded 
by the program control program each time a load request for 
that program is issued* For RPG II programs, RELOAD=YES 
must be specified. However, the storage is freed 
automatically by CICS/VS* For non—RPG II programs, a 
storage control FREEMAIN, rather than a program control 
DELETE, must be used to free the storage. RELOAD=YES must 
not be specified for any program to be executed unless some 
means is devised to issue a FREEMAIN after the program is 
executed. If the FREEMAIN is not issued, the CICS/VS 
dynamic storage area may fill up with copies of the 
program. 

Notes: 

1* When a program is specified with RELOAD=YES and when a 
storage control FREEMAIN is issued, the system programmer 
must subtract 8 bytes from the address at which the program 
is loaded. 

2. RELOAD=YES can be used to load tables or control blocks 
which are modified by execution of the associated 
program (s). It must not be specified for a program which 
is the first program loaded for a task, because the task 
would have no way of issuing a FREEMAIN unless it is for an 
RPG II program (DOS/VS only). 

3. If the dynamic open/close program is to be used, RELOAD=YES 
must be specified in each PPT entry which defines a 
nonresident data set control block. In this case, CICS/VS 
assumes responsibility for releasing the storage occupied 
by nonresident data set control blocks as they are used. 
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4. RELOAD=YES must oe specified for application programs 
written in RPG II. 

5. RELOAD=YES must also be specified for all CICS/DOS/VS 
transient logic modules^ The dynamic open/close program 
maintains a use count for the logic modules to ensure that 
only one copy is in storage at any one time. If the logic 
module is resident in the destination control table, no 
entry is necessary in the PPT. 


| RBS={NO|ALIGN|FIX|PGOUT|YES} 

specifies the residence status of the program. The default is 
RES=NO. 

NO 

means that the program is not to be permanently resident. 
ALIGN 

means the same as RES=YES, except that the program will be 
aligned on a page boundary. ADRSPCE=HIGH (DOS/VS only) in 
DPHALT TYPE=ENTRY causes the end of the program to be page- 
aligned. 


FIX 

means the same as RES=YES, except that the pages containing 
all RBS=FIX programs are permanently fixed and are not 
pageable by the operating system. This option requires the 
CICSSVC operand to be specified, for 0S/VS only, in DFHSG 
TYPB=INITIAL. 

PGOUT 

specifies that the program is permanently resident and 
aligned on a page boundary at initialization time (that is, 
as if RES=ALIGN were specified.) This option is especially 
useful for installations that use a large number of 
programs infrequently. It is, however, inappropriate for 
programs that are heavily used and so would always be using 
real storage. 

In addition, CICS/VS participates in the operating system 
page management by issuing a "force pageout" command when 
the program is no longer in use or will not be needed for a 
relatively long time. The effect is to minimize paging by 
ensuring that the operating system pages out infrequently 
used pages in preference to those that are used frequently. 
The pageout command is issued by CICS/VS to include the 
complete page (s) occupied or partially occupied by the 
program. When the program is next needed, CICS/VS uses an 
operating system macro to force the page containing the 
program # s entry point back into real storage. The page—in 
operation proceeds asynchronously (that is, other CICS/VS 
transactions using different application programs can run 
while the program is being paged in). 

Note: This means that other program(s) or maps occupying 

contiguous space at the bottom of the last page will also 
be included in the pageout list. Therefore, it is the 
user*s responsibility to package application programs and 
maps correctly to achieve a performance improvement from 
the use of this facility* 

For example, a proper way to package a program that uses 
two BBS maps would be as follows: 
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— Define the program as RES^PGOHT to page—align the 
program and to request pageout. 

— Package the two maps contiguously to the program in the 
last page occupied by the program. 

— Define the next program in the table as RES=ALIGN or 
RES=PGOUT so that it does not reside in the same page 
as the pageout program. 

The result of this type of packaging will be that when the 
program completes its execution, CICS/VS will issue a 
pageout command to include the address space used by the 
program and by its maps, and not to include the next 
| program defined in the processing program table. 

IBS 

means that the program is to be loaded at initialization 
time and is to be permanently resident, but is to be 
pageable by the operating system. Programs specified as 
RBS=YES are packed together in the order of the entries in 
the PPT, unless they are also specified in the application 
load table. The order of programs specified in DFHALT 
takes precedence over that in the PPT, and is the 
recommended method of specifying the load order. 

I Note: If a program that is permanently resident is 

| replaced by a larger copy of that program by means of a 

| CSMT new copy command, the program will no longer be 

| permanently resident and will be loaded dynamically. 


t RSL={0|number} 

| indicates the security level, in the range 1 to 24, to be 

| associated with this resource (the application program). The 

| default is RSL=0. 


USAGE=MAP 

specifies that the entry describes a BMS map. When USAGE=MAP 
is specified, the map (or assembler—language program) is loaded 
by program control into MAP storage. If the use count for that 
map or program becomes zero, the MAP storage area is released. 
When tISAGE=MAP is not specified, the map (or program) is loaded 
into PROGRAM storage. If the use count for that map or program 
becomes zero, the PROGRAM storage is not released until if 
becomes necessary to release the storage cushion. Prior to 
releasing the storage cushion, CICS/VS storage management 
releases any PROGRAM storage areas with a use count of zero. 

USAGE=MAP must be specified for maps (or programs) that are 
infrequently referenced. 


| SPECIAL ENTRIES — DFHPPT TYPS=GROOP 


The optional DFHPPT TYPE=GROHP macro instruction allows the system 
| programmer to specify the application program names (required when 
I certain CICS/VS facilities are used) on a functional basis instead of 
| having to specify the PROGRAM=name operands for each individual program 
| being generated in the system. For example, DFHPPT TYPE=GROUP,FN=ATP 
| provides the programs otherwise supplied by specifying: 
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• DFHPPT 

• DFHPPT 

• DFHPPT 

• DFHPPT 

• DFHPPT 

• DFHPPT 


TYPE=ENTRY,PROGRAM =DFHAQP 
TYPE=E5TTRY, PROGRAM=DFHATP 
TYPE=ENTRY,PROGRAM=DFHRD1 
TYPE =ENTRY,PROGRAM=DFHRD2 
TYPE=ENTRY,PROGRAM=DFHWT1 
TYPE=ENTRY,PROGRAM=DFHWT2 


The user should refer to the PPT section of Appendix A for more 
| detailed information on the special entries. Pre-defined entries in a 
TYPE=GROUP macro may be overridden in a DFHPPT TYPE=ENTRY macro coded 
before the TYPE=GROUP macro. Otherwise, TYPE=GROUP and TYPB=BNTRY 
macros can be mixed in any order. The "groupable” entries will not be 
generated twice in an assembly. 


r 

I 

I 

L. 


r 


r 


| DFHPPT | TYPE=GROUP 
I I , FN= (f unction[ 

i-1- 


$ • • • 




*) 


1 


I 

I 

J 


TYPE=GROUP 

| indicates that reguired entries in the PPT are to be generated 

| for the named functions. 


| FN= (functionf,...]) 

indicates the generic function names that generate the entries 
reguired in the PPT for the associated facilities. Any number 
of options from the list below can be specified in one DFHPPT 
TYPE=GRODP macro. The options are: 

AKP 

| generates PROGRAM=DFHAKP for the activity keypoint 

function. 

ATP 

provides the program names associated with the asynchronous 
transaction processing facility. The program names 
generated are: 


• DFHAQP - asynchronous purge queue program 

• DFHATP — asynchronous transaction control program 

• DFHRD1 and DFHRD2 — ATP input processor programs 

• DFHWT1 and DFHWT2 — ATP output processor programs 


AUTOSTAT 

generates PROGRAM=DFHSTSP for the automatic statistics 
summarization program. 

BACKOUT 

generates PROGRAM=DFHDBP for the dynamic transaction 
backout program. PPT entries for the pregenerated versions 
(DFHD3P1$ and DFHDBP2$) will always be generated, and if 
either is missing at initialization time, the error can be 
ignored* 
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3MS 


generates PROGRAM-DFflTPQ, DFBTPR, and DFHTPS for BMS. 
CONSOLE 

generates PROGRAM-DFHCNTO for processing unit console 
support in CICS/DOS/VS, and generates PROGRAM=DFHZCNC, in 
CICS/OS/VS t for processing console abnormal support. 


EDF 

generates the following program names associated with the 
execution (command level) diagnostic facility: 


• DFHEDFP — EDF control program 

• DFHEDFX — EDF task switch program 

• DFHEDFD — EDF display program 

• DFHEDFM - EDF map set 

• DFHEDFF — EDF function description table 

• DFHEDFR — EDF response table 


generates PROGRAM=DFHFEP for the terminal test facility and 
the following program names for the FEES facility error 
logging program under CICS/DOS/VS and BTAM: 


• DFHFELG — FERS logger program 

• DFHFERR — FERS record reorganization program 

• DFHFED1 — FERS display program 

• DFHFED2 — FERS display program 

• DFHFETX — FERS text display program 


HARDCOPY 

generates PROGRAM=DFHP3270 for the 3270 print allocation 
program (BTAM and VTAM) . 

INTERPRETER 

provides programs DFHECIP, DFHECSP, and DFHECID for the 
command interpreter. 


ISC 

generates the following programs for CICS/VS 
intercommunication support and for DL/I shared data base 
support in CICS/OS/VS: 


• DFBMIR 

• DFHRTE 

• DFHCRP 

• DFHCRQ 

• DFHCRR 

• DFHCRS 

• DFHCRNP 

• DFHCRSP 

• DFHMXP 


mirror transaction 

transaction routing program 

relay program for transaction routing 

ATI purge program 

IRC session recovery program 

remote scheduler program 

IRC connection manager 

IRC startup program 

local queuing shipper program 
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JOURNAL 

generates the following programs associated with the 
journal control function: 


• DFHJCBSP — journal tasks "boot strap H program 

• DFHJCC — journal control close program 

• DFHJCEOV — journal control EOV program 

• DFHJCI — journal control input program 

• DFHJCIOE — journal control I/O error program 

• DFHJCKOJ — journal control «kickoff" program 

• DFHJCO — journal control open program 

• DFHJCSDJ — journal control shutdown program 


MASTTERM 

provides programs DFHMTPA through DFHMTPG for the master 
terminal function. 

MSWITCH 

generates PROGRAM=DFHMSP for the message switching program. 
This option also generates the group of programs for the 
BMS function* 

OPENCLSE 

generates PROGRAM=DFHOCP for the dynamic open/close 
function. 

OPERATORS 

provides programs DFHEMTP, DFHESTP, DFHEOTP, DFHEMTD, and 
DFHEMA through DFHEMG for the enhanced master, supervisor, 
and terminal operator functions. 


PL/I 

generates the programs listed in the PPT section of 
Appendix A to provide PL/I support in CICS/VS. 

RECOVERY 

generates the following PROGRAM names associated with the 
recovery/restart facility in CICS/VS: 


• DFHRUP — recovery utility program 

• DFHTSRP — temporary storage recovery program 

• DFHTDRP — transient data recovery program 

• DFHTBP — transaction backout program 


RESEND 

generates PROGRAM=DFHZRSP for the VTAM resend program. 
RESPLOG 

generates PROGRAM=DFHZRLG for the VTAM response logging 
program. 

SIGNON 

generates the program names associated with the sign-on 
program. The programs generated are: 


• DFHSFP — sign-off program 

• DFHSNP — sign—on program 

• DFHSNT — sign-on table 
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STANDARD 

provides the application program names that are required in 
all CICS/VS systems. The program names generated are: 


• DFHACP — abnormal condition program 

• DFHCCMF — periodic monitoring program 

• DFHCMON — start/stop monitoring program 

• DFHSTP — system termination program 

• DFHSTLK — intercommunication link statistics program 

• DFHSTKC — supervisor statistics program 

• DFHSTPD — transaction, program, and dump 

statistics program 

• DFHSTTD — data management statistics program 

• DFHSTTR — file and terminal statistics program 

• DFBTACP — terminal abnormal condition program 

• DFHTBP — terminal error program 

The programs generated by FN=STANDARD are low—usage 
programs and must be generated towards the end of the PPT. 


TIME 

generates PROGRAM=DFHTAJP for the time adjustment program. 

VTAM 

generates PROGRAM=DFHZNAC and DFHZNEP for the VTAM node 
abnormal condition and node error programs and DFHGMM for 
the VTAM good morning sign-on message program. 

VTAMPRT 

generates DFHCPY, DFHEXI, DFHPRK, and DFHRKB for the VTAM 
3270 terminal control print key function. 


END OF PROCESSING PROGRAM TABLE — DFHPPT TYPE=FINAL 


The end of the processing program table is indicated to the control 
system by the DFHPPT TYPE=FINAL macro instruction, which is the last 
statement in the assembly of the processing program table before the 
assembler END statement. This macro instruction creates a dummy entry 
to signal the end of the table. 


r 

I 

L 


I-“I- 

IDFHPPT | TYPE=FINAL 


L 


L 


T 

I 


i 


TYPB=FINAL 

indicates the end of the processing program table. 


EXAMPLE 


| Figure 3.2—13 illustrates the coding that is required to create a 
processing program table. The programs include: 

• Four assembler—language programs, one of which is resident 

• Four ANS COBOL programs 
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DFHPPT TYPE=INITIAL 
DFHPPT TYPE=ENTRY, 

PR0GRAM=C0BPGM1, 

PGMLAN G=COBOL 
DFHPPT TYPE=ENTRY, 

PROGRAM=C0BPGM2, 

PGMLANG=COBOL 
DPHPPT TYPE=ENTRY, 

PROGRAM=COBPGM3 , 

PGMLANG=COBOL, 

RELOAD=YES 
DPHPPT TYPE=ENTRY, 

PROGRAM=COBPGM4, 

PGMLANG=COBOL 
DFHPPT TYPE=ENTRY, 

PROGRAH=DFHACP 
DPHPPT TYPE=GROUP, 

FN=TIME 

DFHPPT TYPE=ENTRY, 

PROGRAM=DFHMTPA, 

RES=YES 

DPHPPT TYPE=ENTRY, ♦ 

PROGRAM=DFHSNP 

DPHPPT TYPE=ENTRY, ♦ 

PROGRA C!=DFHZNAC 

DPHPPT TYPE=ENTRY, * 

PROGRAM=DPH2RLG 

DPHPPT TYPE=GROUP, ♦ 

PN=STANDARD 
DFHPPT TYPE=PINAL 
END 

| Figure 3.2-13. Processing Program Table — Example 


SIT — SYSTEM INITIALIZATION TABLE 


The initialization of CICS/VS is both flexible and dynamic. The 
flexibility at the time of initialization is provided by the system 
initialization table (base name: DFHSIT)* The contents of the DPHSIT 
macro instruction, which is assembled as a table, supplies the system 
initialization program with the information to initialize the system to 
suit the user*s unigue environment. During the initialization process, 
the user is given an opportunity to change some of the parameters 
dynamically, as required. 

The information contained in DPHSIT may be grouped into three 
categories for purposes of discussion: 

• Information used to initialize and control system functions (for 
example, storage cushion size, partition/region exit time interval, 
and so on). 

• Module suffixes used to load the user-specified version of the 
CICS/VS control modules and tables (for example, DPHPCTxx, 

DFHFCPxx, and so on). 

• Special information used to control the initialization process. 

The user also has the flexibility of generating several system 
initialization tables and selecting the appropriate one at the time of 
initializ atio n. 
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1- 

r 



f 


| DFHSIT 

i 

TYPE= fCSECT1DSECT1 ] 



i 

i 

[,ABKPOPT={BOI*BS }j 



i 

i 

[ ,AKPFREQ={0|decimal—value} ] 



i 

i 

[,ALT={NO|xx|YES}] 



i 

i 

f »AMXT={MXT—value 1 decimal—value! ] 



i 

i 

r.APPLID= fDBDCCICS1 name) ] 



i 

i 

[ , ATP= ([ {NOjYES} ],[ {COLB|WARM} ]) ] 



i 

i 

T.ATPINS=f10001 number)} 



i 

i 

r,ATP0UTS=f10001 number*] 



i 

i 

T,ATPMB=(MXT-11decimal-value} 



i 

i 

[,ATPMT={11number} ] 



i 

i 

[,BFP={YES|XX|NO}] 



i 

i 

[ ,BMS=([ {NO|YES} ],[ {COLD | WARM} ]) ] 



i 

i 

[ ,CMXT= {[V1][ ,V2 ]....[ V10 ]) ] 



i 

i 

[,CMP={NO|YES JXX} ] 



i 

i 

[ ,CSA=([ {YES|xx} ],[ {COLD|WARM} ]) ] 



i 

i 

T #DATFORM= fHMDDYYIDDHMYYIYYMMDD} 1 




i 

[ , DBP= {NO | xx | YES} ] 



i 

i 

[ , DBPFSZ=f5001nnnnnl ] 



i 

i 

[,DCP={YES|xx|NO}] 



i 

i 

[ ,DCT= ([ {YES |xx |NO} ],[ {COLD | WARM} ]) ] 



i 

i 

[ ,DIP=[ {NO(YES|xx} ] 



i 

i 

[ , {DLI | DL1} = ([ {NO | YES | XX} ],[ {COLD| WARH} ]) ] 



i 

i 

[ # DSB={YES|xx}] 



i 

i 

[ , EXEC= {YES | NO} ] 



i 

i 

[ ,EXITS={NO|YES} ] 



i 

i 

[,EXTSBC={NO|YBS} ] 



i 

i 

[,F2260={NO|YES|xx} ] 



i 

i 

[,FCP={YES|xx}] 



i 

i 

[ ,FCT=([ {YES |xx | NO} ],[ {COLD | WARM} ]) ] 



i 

i 

T ,FDP=(rxxl. (FORMAT 1PARTN1 NOI . (SNAPIPDOMPH 1 



i 

i 

[ .FLDSEP=f»WMM» | *xxxx'} ] 



i 

i 

[,FLDSTRT={*^*|‘character*}] 



i 

i 

[,ICP=([ {YES | xx} ],[ {COLD|WARM} ]) ] 



i 

i 

T »ICV=f10001 decimal—valuel1 



i 

i 

T #ICVR=(50001 decimal—valuel 1 



i 

i 

T,ICVS=(20000Idecimal-valuel 1 



i 

i 

[,ICVTSD=[decimal—value] 



i 

i 

[,IIP={YES|XX}] 



i 

i 

[ ,IRCSTRT={NO|YES} ) 



i 

i 

[,ISC={NO|YES|xx} ] 



i 

i 

r,JCP={YES{XX} ] 



i 

i 

[,JCT={([ {YES | xx} ][, {TAPE | DISK} ]) |NO} ] 



i 

i 

[ ,KCP={YES|xx} ] 



i 


[,K PP={YE S|xx|NO}] 



i 

i 

[,M32={YES|XX}] 



i 

i 

[,MCP={YES|xx}] 



i 

i 

[,MCT={NO|YES|XX}] 



i 

i 

[ ,MONITOR= ([ ACC ][ ,PER )[ , EXC]) ] 



i 

i 

[ ,MSGLVL= {1.1 2 |0} ] 



i 

i 

[,MXT={5|decimal—value}] 



i 

i 

[ .NLT= (NOIxxl YES} ] 



i 

i 

[ , PBP={YES|xx}] 



i 

i 

[ ,PCP={YES|XX}] 



i 

i 

[ ,PCT= ([ {YES |xx} ],[ {COLD | WARM} ]) ] 



i 

i 

[,PGCHAIN=character(s)] 



i 

i 

[,PGCOPY=character(s) ] 



i 

i 

[,PGPURGE=character(s) ] 



i 

i 

[,PGRET=character(s)] 



i 

i 

[,PGSIZE=(204814096} ] 


L. — 

i_ 

-L 


.A 
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[ , {PL1|PLI} = {N0|YES} ] 

[ ,PLTPI={NO|XX|YES} ] 

[ ,PLTSD={NO|XX|YES} ] 

r ,PPT= (r (YES Ixxl ],[ (COLD | WARM | HOT} ]) ] 

[,PRGDLAY=hhmm] 

[,PRINT={MO|YES|PA1|PA2|PA3}] 

[,RLR={YES|XX}] 

[ ,SCP= {YES | xx} ] 

[,SCS= (500 1 decimal—value}] 

[ »SIMODS= (A 1.31.Cl.PI,El .PI ,G1 .H1.I1.J~U \ (phase,. *.) ] 
[,SKRxxxx=*page—retrieval-command*] 

[,SBP=(YES|xx} ] 

[,SRT={YES|xx|NO} ] 

[ ,START= {COLD|WARM} ] 

[ ,SUFFIX=XX] * 

[ ,SVD={NO|YBS|nn} ] 

[,TCP=(YES|XX|NO}j 
[ ,TCT= ([ {YES | XX} ],[ {COLD |WARM} ]) ] 
f,TDP={YES|XX} 1 
[,TPP={YES|xx}] 

[ ,TRP=([ {YES | xx} ],[ {ON | OFF | AOX} ] 

[,TRT»{01decimal—value} ] 

[,TSMGSET={4(number} ] 

[ ,TSP= ([ {YES|xx} ],[ {COLDIWARM} ]) ] 

[,TST={NO|YES|xx}] 

[,WRKAREA= (512 1 number}) 

[,XLT={NO|xx|YES}] 

[,XSP={NO|YES|xx}J 
[,XTP={NO|YES|xx} ] 

[,ZCP={YES|XX} ] 

CICS/DOS/YS Only 

[ , FERS= (YES I NO | ALL} ] 

[,ICVSWT=(401 decimal—value! ] 

[ ,NSD={01num ber} ] 

CICS/OS/VS Only 

[,B0FPL={8|number}] 

[ ,DDIB={YES|xx} ] 

[ ,DLTHRED={j.)decimal—number} ] 

[ ,DHBPL= {4Inumber}] 

[ ,ENQPL= (21number} ] 

[ ,IOCP={01 number} ] 

[,LPA={NO|YES} ] 

[ ,OSCOR={81921decimal-value} ] 

[,PDIR={YES|xx}] 

[ ,PISCHD={NO|YES}] 

[ ,PLISBRE= {NO | YES} ] 

[ ,PSB={CICSPSB|name}] 

[ ,PSBPL={4|number} ] 

[,XPSB= (C1CSPSB |name}] 

[,XTRAN= (CICSTRN I name}] 


* See the first page of this chapter. 
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Notes : 

1. When the dummy version of a module is to be included in the system 
initialization table (either while generating DFHSIT or in the 
override parameters during start—up time), "Module name" =N0 and 
not "Module name" =DY must be specified, unless the function to be 
dummied has an associated table. If it does, "Table name" =NO must 
be specified and nothing need be specified for "Module name". 

Example without table: KPP=NO or DCP=NO 

Example with table: FCT=NO or DCT=NO 

| 2. The operand specifies the type of start that the system 

initialization program will make for that facility. The default is 
the option specified in the START operand. 

The operand indicates that a suffixed version or a dummy module can 
be loaded. 

xx 

indicates the one— or two-character suffix that is to be 
appended to the standard name before loading the CICS/VS 
nucleus. For example, KCP=B1 causes the DFHKCPB1 task 
control module to be included in the CICS/VS nucleus. 

YES 

indicates that an unsuffixed version of the program, 
module, or table will be loaded. 

NO 

indicates that a dummy module is to be loaded. For 
example, FCT=NO, SRT=NO, JCT=NO, and DCT=NO causes a dummy 
FCP, a dummy SRP, a dummy JCP, and a dummy TDP to be 
loaded, respectively. 

Note that when the suffix option is specified with other 
parameters, the two parameters must be enclosed within 
parentheses: for example, JCT= (xx,DISK). 

3. The following parameter descriptions apply to the modules that 
contain a reference to Note 2. 

COLD 

indicates a cold start 

WARM 

indicates a warm start 

Note : Individual facilities may differ from the value 
| specified in the START parameter when keypointing is used or 

| when the appropriate tables are loaded from the keypoint data 

| set. For example: START=COLD and FCT= (01,WARM) . In this case 

the FCT would be warm started, while the default for the 
facilities not specified is a cold start. 
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I 4. Since, by specifying XSP=NO, security checking in the system can be 
| disregarded, users who are concerned about this should either not 

| allow console overrides or delete the dummy XSP module from their 

I libraries. 


TYPE= {CSECT | DSECT} 

indicates the type of system initialization table to be 
generated. The default is CSECT. 

CSECT 

indicates a regular control section and is normally used. 
DSECT 

indicates a dummy control section. 

| If modified or additional system initialization modules are 

coded by the user, a DSECT may be required to provide 
symbolic addressability to values in the table. 


ABKPOPT={NO|YES} 

specifies whether keypointing is to be performed during an 
abnormal termination intercepted by the system recovery program 
(DFHSRP). The default is ABKPOPT=NO. 

NO 

indicates that keypointing will not be used with DFHSRP. 

YES 

indicates that keypointing will be used with DFHSRP. 


| AKPFREQ={0|decimal—value} 

specifies how frequently activity keypoints are to be taken* 

If AKPFREQ=0 {the default) is specified, no activity keypoints 
will be taken* If AKPFREQ is a value other than zero, it 
specifies the number of consecutive write operations to the 
system log data set that will trigger the activity keypoint 
function* The range is 200 to 65535. 


| ALT={N0|XX| YES} 

specifies the application load table used to control the load 
order of resident application programs. The default is ALT=NO. 

NO 

indicates that the PPT, not the ALT, will be used to 
determine the load order of resident application programs. 

xx 

is a one— or two-character suffix that specifies which 
application load table is to be used. 


YES 

indicates that the load order specified in the ALT will be 
used. 
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I AMXT= ( MXT—value I decimal—value! 

specifies the maximum number of tasks (excluding journal 
control tasks and the terminal control task) that CICS/VS will 
inspect during its dispatch scan; that is, the maximum number 
of tasks that CICS/VS will allow to be active concurrently• 

The value specified in the MXT operand (see below) sets a limit 
on the number of tasks that CICS/VS will initiate concurrently 
(that is, put into the active chain)* The AMXT value controls 
the number of initiated tasks that CICS/VS will consider for 
dispatching. 

The range is 1 to 999. The default value for the number of 
maximum active tasks is equal to the maximum task value 
specified in the MXT operand* 

This parameter is especially useful in a conversational CICS/VS 
environment where the maximum task value (in the MXT operand) 
is not an effective tuning tool, and would normally be set 
higher than the number of concurrent tasks the system is 
capable of servicing effectively. 

The maximum active task value can be used by the conversational 
CICS/VS environment to control the load on CICS/VS without 
limiting the number of terminals in use• 

If the maximum active task value is set too low in an 
environment where tasks can wait for the completion of events 
being processed by other tasks, a lock-out can occur. It 
occurs mostly when one task attaches another and then waits for 
the completion of an event processed by the new task. The new 
task may be locked-out from running because of the presence of 
enough tasks of the first type to equal the maximum active task 
number. The user can prevent this condition by using a 
sufficiently high maximum active task value (AMXT) and/or a 
class maximum task value (CMXT), that is lower than the maximum 
active task value, on tasks that wait for events from other 
tasks. 

If a stall condition occurs while CICS/VS is at the AMXT limit, 
the AMXT value will be temporarily increased to allow other 
tasks to be dispatched. This action is taken on the assumption 
that it may relieve an interlock situation * 


APPLID= fD BDCCICS |name) 

specifies a one— to eight—character application name of the 
CICS/VS system. If this operand is not specified in DFHSIT, 
DFHTCT TYPE=INITIAL, or as a system initialization override, 
APPLID will default to DBDCCICS. 

| It is used as the ACF/VTAM APPLID and is also the name by which 

the CICS/VS system is known to other CICS/VS systems, including 
the batch system (for DL/I shared data base support in 
| CICS/OS/VS). The name specified in this operand must also be 

| used in the NETNAME operand in DFHTCT TYPE^SYSTEM or DFHTCT 

| TYPE=TERMINAL for the remote system or region when CICS/VS 

| intercommunication facilities are being used. 

| The name specified must match the label specified in the 

| ACF/VTAM VBUILD TYPE^APPL definition. This is the globally 

| known name in the network. If an ACBMAME is coded, this may be 

I used as the name by which logical units in the same domain 

| logon to CICS/VS, however, CICS/VS has no knowledge of this 

| name. 


I 

I 

I 

I 
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ATP=({NO| YES} , {COLD |WARM}) 

specifies whether the asynchronous transaction processing 
facility (ATP) is to be supported. The default is ATP=NO. 

NO 

indicates that ATP support is not desired. 

YES 

indicates that ATP support is desired. 

COLD 

indicates a cold start. 

WARM 

indicates a warm start. 


ATPINS= f1000 inumber} 

specifies the size (in bytes) of the input buffer used by the 
asynchronous transaction input processing programs. The value 
specified must not exceed the full track capacity for the 
device being used, or, in the case of CICS/OS/VS, must not 
exceed the block size specified on the intrapartition data set 
data definition (DD) card at startup time. The default is 
INBUFF=1000. 


ATPOUTS= f 1000 1 number} 

specifies the size (in bytes) of the output buffer used by the 
asynchronous transaction control program. The value specified 
must not exceed the full track capacity for the device being 
used, or, in the case of CICS/OS/VS, must not exceed the clock 
size specified on the intrapartition data set data definition 
(DD) card at startup time. The default is OUTBUFF=1000. 


| ATPMB= fMXT-1 1 number} 

specifies, as a decimal value, the asynchronous task inhibitor 
value. When the number of active tasks (both synchronous and 
asynchronous) reaches this level, the asynchronous transaction 
processing control program (DFHATP) does not initiate any new 
asynchronous tasks, even though the number of asynchronous 
tasks currently active is less than the value specified in the 
ATPMT operand. Thus, even though no asynchronous tasks are 
active, none are initiated if the total of all other active 
tasks has reached the level specified in this operand. The 
default value is agual to one less than the value specified in 
the MXT operand. The range is 1 to 998. ATPMB must be less 
than MXT. 


| ATPMT 35 Q| number} 

specifies, as a decimal value, the maximum number of 
asynchronous tasks that can be initiated concurrently within 
CICS/VS by the asynchronous transaction processing control 
program (DFHATP). When the number of active asynchronous tasks 
reaches this level, no new asynchronous tasks are initiated by 
DFHATP. The range is 1 to 998, with a default of 1. ATPMT 
must be less than or equal to ATPMB. 


| BFP={YES|xx|NO} 

built-in functions program suffix — see Note 2 at the beginning 
of the description of this macro. 
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BMS=({NO|YES} , {COLD | WARM}) 

specifies whether basic mapping support is to be included* 

This operand determines whether the BMS modules will be loaded. 
The BMS modules (IIP, MCP, M32, PBP, BLR, DSB, and TPP) are 
individually suffixable. The default is BMS=NO. 

NO 

indicates that a dummy basic mapping support module is to 
be loaded. 

YBS 

indicates that basic mapping support will be included. 

COLD 

indicates cold start BMS ICEs. 

WARM 

| indicates warm start BMS ICEs. ICP=WARM and TSP=WARM must 

| also be specified when the system is initialized. 

I 

| CMXT= ([VI ][ ,V2]....[V10]) 

| specifies the maximum number of tasks that may exist in any of 

the ten transaction classes. The options are positional and 
must be enclosed in parentheses. This means that the first 
position applies to class 1, the second to class 2, and so on, 
up to class 10. The value specified for each class may be from 
1 to 999, but must not exceed the maximum task value (MXT). 

The default is 1. 

Example: 

CMXT= (5,,,3,,4,,8,,6) 

where class 1 is set to 5, class 4 to 3, class 6 to 4, class 8 
to 8, and class 10 to 6. Classes 2, 3, 5, 7, and 9 default to 
1 . 

The use and purpose of the classes are entirely at the 
discretion of the user. The following is an example of how the 
classes may be used: 


1 

^ 3 

4 

5 through 10 


— Inquiry—only transactions 

-— Update or add transactions 

— Pile browse or weighted retrieval 
transactions 

— Auto—initiated tasks (such as ICP or TDP 
transactions) 

— Could be used to group transactions by 
other characteristics (such as similar 
working set sizes) 


| CMP= {NO | YES | xx} 

| monitoring program suffix — see Note 2 at the beginning of the 

| description of this macro. 


| CSA“ ({YES| XX} ,{COLD|WARM}) 

I common system area suffix — see Notes 2 and 3 at the beginning 

of the description of this macro. 
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| DATFORM= fMttDPYY lDPMMYYIYYMMDD1 

specifies the external date display standard desired by the 
user. An appropriate indicator setting is made in the CSA. It 
is examined by CICS/VS supplied system service programs that 
display a Gregorian date. As part of their operation, the 
indicator can also be examined by customer—written programs. 

It is the user*s responsibility to supply a Gregorian date 
conversion routine because CICS/VS maintains the date in the 
| form YYDDD in the CSA. The default is MMDDYY. 

MMDD YY 

| indicates the date will be in the form of month—day— year. 

DDMMYY 

| indicates the date will be in the form of day—moath—year. 

YYMMDD 

| indicates the date will be in the form of year—month—day. 


| DBP= {NO|xx|YES} 

indicates which version of the dynamic transaction backout 
program (if any) is to be part of the system (see Note 2 at the 
beginning of the description of this macro). 

If a suffixed version is specified, an entry for that dynamic 
transaction backout program (DFHDBPxx) must be made in the PPT. 


DB0FSZ= {500|number} 

indicates the size in bytes of the dynamic buffer that is used 
by dynamic transaction backout. The default is 500. The size 
of the buffer must be large enough to accommodate a copy of 
each file or DL/I record that is updated in a typical LUW and 
is written to the dynamic log. If the data exceeds the 
specified buffer size, records spill on to temporary storage. 
The size of the buffer to be specified should be weighed 
against the overheads of using too much main storage and 
spilling too often on to temporary storage* 

Furthermore, the size of the dynamic buffer must be small 
enough to fit into the temporary storage control interval. For 
information on how to calculate the dynamic buffer size in 
relation to the control interval size, refer to the appropriate 
CICS/VS System Programmers Guide (DOS/VS or OS/VS) . 

Further information on the dynamic log can be found under “User 
Exits for Dynamic Transaction Backout* 1 in Chapter 4*4. 

500 

indicates that the size of the dynamic buffer is 500 bytes, 
nnnnn 

indicates the size of dynamic buffer and must be in the 
range 6 to 32000. 


| DCP= {YESJ NO | xx} 

dump control program suffix — see Note 2 at the beginning of 
the description of this macro. If DCP=N0 is specified, a 
formatted dump will not be taken. 
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| DCT= ( {YES |XX| NO} , {COLD | WARM}) 

I destination control table suffix — see Notes 2 and 3 at the 

beginning of the description of this macro* 


DIP={NO|YES|xx} 

batch data interchange program suffix — see Note 2 at the 
beginning of the description of this macro* 


| {DLIIDL1} = {NOfYES|xx} ,[ {COLD| WARN} ] 

indicates whether Data Language/I (DL/I) data bases are to be 
accessed during execution of CICS/YS. The default is DL1=N0. 
| This parameter is not required if DL/I ENTRY is being used* 

NO 

indicates that DL/I will not be used. 

YES 

indicates that DL/I will be used* 
xx 

| indicates, for CICS/DOS/VS only, a one— or two—character 

j suffix to be appended to the DL/I nucleus module DLZNUC. 


COLD 

indicates a cold start. The default is the option 
specified in the START operand. 


| WARN 

| indicates a warm start. 


| DSB= {YES | xx} 

data stream builder (BBS) suffix — see Note 2 at the beginning 
of the description of this macro. 


EXEC={YES |NO} 

indicates whether command (EXEC) level support is required* 

The default is EXEC=YBS. 

YES 

indicates that command (EXEC) level support is required and 
must be specified (or allowed to default) if any command 
level applications are to be used. It is also required if 
intercommunication facilities are to be used, but not for 
transaction routing. 

NO 

indicates that command (EXEC) level support will not be 
used. 


| EXITS= {NO | YES} 

| indicates whether the user exit interface is to be used. The 

| default is BXITS=NO. Further information on this interface can 

j be found in Chapter 6.2. 

I NO 

| indicates that the user exit interface will not be used. 
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YES 


indicates that the user exit interface will be used. If 
EXITS=YES is specified then EXEC=YES must also be 
specified. 


EXTSEC={NO|YES} 

indicates whether an external security facility (for example, 
RACF under MVS) will be used in this run of CICS/VS. The 
default is BXTSEC=NO. 

NO 

indicates that an external security facility will not be 
used. 

YES 

indicates that an external security facility will be used 
as well as the CICS/VS—provided transaction security 
function. This requires that a non—dummy version of DPHXSP 
be used, which interfaces with an external security 
facility. 


F2260={NO|YES|xx} 

specifies whether FASTER 2260 compatibility modules are to be 
included. FASTER 2260 modules (FIP and F2P) are suffixable. 
The default is F2260=NO. 


NO 

indicates no FASTER 2260 compatibility. 

YES 

indicates that FASTER 2260 support is to be included 
(modules FIP and F2P are not suffixed). 

xx 

indicates that FASTER 2260 support will be used and 
identifies the suffixes that will be appended to modules 
DFHFIP and DFHF2P. 


| FCP={YBS|xx) 

file control program suffix — see Note 2 at the beginning of 
the description of this macro. 


| FCT= ( fYES IXXlNOI .{COLD|WARM}) 

j file control table suffix — see Notes 2 and 3 at the beginning 

of the description of this macro. 


| FDP= ([xx], {F0RMAT|PARTN|N0} , {SNAP | PDUMP} ) 

specifies the type of dump that is to be produced if CICS/VS 
terminates abnormally, if a system abend or storage violation 
occurs, or if CSMT SNAP with no parameters is entered. For an 
abnormal termination or an unrecoverable abend, CICS/VS 
terminates after the dump is completed. In the other cases, 
CICS/VS continues normally after the dump is completed. The 
default is FORMAT. 
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XX 


specifies the two—character suffix for the formatted dump 
program (DFHFDP) . 

Mote: The formatted dump program provided by CICS/VS is 
unsuffixed; tne suffix should only be used for user—written 
or user—modified versions of the formatted dump program. 

PARTN 

requests a dump of the CICS/VS partition. 

FORMAT 

requests a formatted dump only. This is a dump of the 
major CICS/VS control blocks arranged in a logical order. 
The hexadecimal offsets of the major fields in each control 
block are displayed, together with the contents of the 
fields. The formatted dump program also checks for errors 
| in the contents of the control blocks. 

NO 

requests a CANCEL or ABEND dump, but only in the case of an 
abnormal termination. If CSMT SNAP is issued, no dump will 
be produced. 

SNAP or PDUMP 

requests that, when a partition dump is invoked as a result 
of a PARTN request, the formatted dump program should issue 
| a SNAP (OS/VS) or PDBMP (VSE) request instead of writing 

| the dump to the dump data set. Note that the dump data set 

| is still required, even though the dump is not written to 

| it. 

Note : The output of the formatted dump program is normally 

directed to the dump data set via the dump control program 
unless FDP=(,NO) is specified. If a dummy dump control program 
is used (DCP=NO in this macro) no formatted dumps will be taken 
either. 


| FLDSBP-II»xxxx«) 

specifies one to four field separator characters, each of which 
indicates end—of—field in the terminal input data. This 
permits the use of transaction identifications of less than 
four characters followed by one of the separator characters. 
When less than four characters are specified, the parameter is 
| padded with blanks, so that blank is then a field separator. 

(See also "Input Formatting 11 under "CICS/VS Built-In Functions” 
in the CICS/VS Application P ro<Trammer»s Reference Manual .) The 
default is four blanks. 

| None of the specified field separator characters should be part 

I of a transaction identification (that is, the use of alphabetic 

| characters is not recommended.) 


| FLDSTRT-f |•character*} 

specifies the single character considered to be the field—name- 
start character by free—form input for built-in functions. The 
default is one blank. 

Note: The character specified in the FLDSTRT parameter must 

not be the same as any character specified in the FLDSEP 
parameter. This means it is invalid to allow both parameters 
to take the default value. 
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| ICP= ( fYES I XX} , (COLD I WARM} ) 

I interval control program suffix — see Notes 2 and 3 at the 

beginning of the description of this macro. 


| ICV= HOOP | decimal—value} 

specifies the partition/region exit time interval in 
milliseconds. The partition/region exit time interval is the 
maximum interval of time for which CICS/VS releases control to 
the operating system in the event that there are no 
transactions ready to resume processing. This time interval 
can be any three— to seven—digit decimal value in the range 
| from 100 to 327670 milliseconds (the default is ICV=1000). A 

typical range of operation might be 100 to 2000 milliseconds. 
The value chosen must not be greater than the values specified 
in the ICVR and ICVS operands. 

A low value interval can enable much of the CICS/VS nucleus to 
be retained in dynamic storage, and not be paged—out at times 
of low terminal activity. This reduces the amount of dynamic 
storage paging necessary for CICS/VS to process terminal 
transactions (thus representing a potential reduction in 
response time), sometimes at the expense of concurrent batch 
partition/region throughput. Large networks with high terminal 
activity are inclined to drive CICS/VS without a need for this 
value, except to handle the occasional, but unpredictable, 
period of inactivity* These networks can usually function with 
a large interval (10000 to 30000 milliseconds). Once a task 
has been initiated, its requests for terminal services and the 
completion of the services are recognized by the system and 
this maximum delay interval is overridden. 

Small systems or those with low terminal activity are subject 
to paging introduced by other jobs running in competition with 
CICS/VS. By specifying a low value interval, key portions of 
the CICS/VS nucleus are referenced more frequently, thus 
reducing the probability of these pages being paged-out. 
However, the execution of the logic, such as terminal polling 
activity, without performing productive work might be 
considered wasteful. The need to increase the probability of 
residency by frequent, but unproductive referencing must be 
weighed against the overhead and response time degradation 
incurred by allowing the paging to occur. By increasing the 
interval size, less unproductive work is performed at the 
expense of performance if paging occurs during the periods of 
CICS/VS activity. 

Note: If the terminal control negative poll delay feature is 
used, the ICV value selected must not exceed the negative poll 
delay value. If the negative poll delay used is zero, any ICV 
value may be used. 
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| ICVR={5000(decimal—value} 

specifies the runaway task time interval in milliseconds as a 
| decimal value. The range is 0 through 2700000, with a default 

| of 5000. lifter this length of time, CICS/VS will disable the 

| task that has gone into a loop between two CICS/VS macros. If 

ICVR=0, runaway task control is suspended for the duration of 
the current execution of CICS/VS* 

The value chosen must not be less than the value in the ICV 
operand, and will be rounded down to the nearest multiple of 10 
milliseconds. For further information, see the CICS/VS 
Operator % s Guide . 


{20000|decimal—value} 

specifies the system stall time interval in milliseconds as a 
decimal value. The range is 0 through 327670, with a default 
of 20000. After this length of time, CICS/VS will disable the 
lowest priority task* Specifying ICVS=0 does not cause the 
system stall time interval to be suspended. 

The value chosen must not be less than the value in the ICV 
operand, and will be rounded down to the nearest multiple of 10 
milliseconds. For further information, see the CICS/VS 
Operators Guid e. 


ICVTSD=decimal—value 

indicates that the terminal scan delay facility is required. 
This is an alternative to the full ICV value, and represents 
the interval after which CICS/VS will scan the TCT again after 
it has finished processing to service BTAW output requests. A 
tradeoff should be made between improved response times on 
output and increased processor utilization. A value of close 
to 0 is recommended. The range is 0 through 100000 
| milliseconds, with a default of ICVTSD=0 in VSE and ICVTSD=1000 

| in OS/VS. 


| IIP={YES|xx} 

input independence program (BMS) suffix — see Bote 2 at the 
beginning of the description of this macro. 


IRCSTRT={NO|YES} 

indicates whetner the interregion environment that will be used 
| in a shared data base session between CICS/VS and the DL/I 

batch region (CICS/OS/VS only), or in an BRO session between 
multiple CICS/VS regions will be started—up at system 
initialization. The default is NO. If IRCSTRT=YBS is not 
specified, the interregion environment can be initialized by 
| issuing a CEMT SET IRC OPEN command. 


| ICVS= 

I 

I 

I 

I 


ISC={NO|xx|YES} 

| CICS/VS intercommunication group suffix for DFHISP, DFHELR, 

yjf DFHXTP, and DFHXFP. 


| JCP={YES|xx} 

journal control program suffix — see Note 2 at the beginning of 
the description of this macro. 
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I JCT={([ {YES | XX} ][ , {TAPE | DISK} }) |N0} ] 

specifies a journal control table that contains information 
| about journal files or data sets* See also Motes 2 and 3 at 

the beginning of the description of this macro. 

TAPE 

specifies, for emergency restart purposes, that the system 
log resides on tape. 

DISK 

specifies, for emergency restart purposes, that the system 
log resides on disk. 


| KCP= {YES|xx} 

task control program suffix — see Mote 2 at the beginning of 
the description of this macro. 


| KPP=(YES|XX|NO} 

keypoint program suffix — see Note 2 at the beginning of the 
description of this macro. 


| M32={YBS|xx} 

3270 mapping (BUS) suffix — see Note 2 at the beginning of the 
description of this macro. 


| MCP= {YES | xx} 

mapping control program (BUS) suffix — see Note 2 at the 
beginning of the description of this macro. 


| MCT={NO I YES| XX} 

| monitoring control table suffix — see Note 2 at the beginning 

I of the description of this macro i 


| MONITOR = ([ ACC][ ,PER ][ ,EXC ]) 


indicates the class of monitoring which will be initially 
active on this run of CICS/VS. The default is that no 
monitoring classes will be active. 


ACC 


indicates that accounting class information is to be 
recorded. 


PER 


indicates that performance class information is to be 
recorded. 


EXC 


indicates that exception class information is to be 
recorded. 


| MSGLVL= (J. | 0 12} 

specifies a message level that controls the generation of 
messages to the console during system initialization. The 
default is MSGLVL=1. 

1 

indicates that all messages are to be printed. 
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0 

indicates that only critical I/O errors or interactive 
messages are to be printed. 

2 (CICS/DOS/VS only) 

indicates that all messages are to be printed on SYSLST and 
SYSLOG. 


| MXT= {51 decimal—value) 

specifies the maximum number of tasks (both synchronous and 
asynchronous) that can be initiated concurrently within 
CICS/VS. When the number of tasks reaches this level, no new 
tasks are initiated by the terminal control program. The 
default is NXT=5. The range is 2 to 999. 

Note : In a system using journaling, the maximum number of 

tasks must include one task for journaling and one task for 
each journal. 


| NLT = {NO | XX | YES) 

specifies a nucleus load table* The table is used to control 
the load order of the CICS/VS nucleus. The default is NLT=NO• 

NO 

indicates that the default load order is to be used. The 
default load order is described in the nucleus load table 
macro earlier in this chapter. 

xx 

is a one— to two—character suffix that specifies which 
nucleus load table is to be used. 

| YES 

| indicates that an unsuffixed NLT will be loaded* 


PBP={YES|xx) 

page build program (BMS) suffix — see Note 2 at the beginning 
of the description of this macro. 


| PCP= {YES | xx) 

program control program suffix — see Note 2 at the beginning of 
the description of this macro. 


| PCT= ( fYES \ xx) .(COLD I WARM) ) 

| program control table suffix — see Notes 2 and 3 at the 

beginning of the description of this macro. 


PGCBAIN=character (s) 

| is the character string that is to be recognized by terminal 

| control as a BNS terminal page—chaining command* It can be 

| from one to seven characters. 

| See notes following PGRET operand* 
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I 


PGCOPY=character (s) 

is the character string that is to be recognized by terminal 
control as a BMS command to copy output from one terminal to 
another. It can be from one to seven characters. 

| See notes following PGRET operand. 


PGPURGE=character(s) 

is the character string that is to be recognized by terminal 
| control as a BMS terminal page—purge command. It can be from 

one to seven characters. 

| See notes following PGRET operand. 


PGRET=character(s) 

is the character string which is to be recognized by terminal 
| control as a BMS terminal page—retrieval command. It can be 

from one to seven characters. 

Notes: 

1. Each character string should be unique with respect to the leading 
characters of every other transaction identification defined in the 
program control table (DFHPCT)* In particular, it should be noted 
that a command requested by a single character precludes the use of 
all other transaction identifications starting with this character. 

2. A field—separator or other suitable delimiter may be specified in 
each character string in order to separate this command code from 
the remainder of the paging command when entered by an operator. 

For example: 

PGCHAIN = X/ 

PGCOPY = C/ 

PGPURGE = T/ 

PGRET = P/ 

This also reduces the risk of creating a non—unique command (see 
Note 1) . 

| 3. PGCHAIN, PGCOPY, PGPURGE, and PGRET are only required if PAGING=YES 

| is specified for the DFHSG PROGRAM=BMS macro instruction. For 

| further information see the CICS/YS Operators Guid e. 

4. CICS/VS will always process a paging command entered by the 

operator before initiating a transaction in response to a macro 
request, which consists of either DFHBMS or DFHPC with the TRANSID 
operand specified. 


PGSIZE= (2048 |40961 

indicates a decimal value for the number of bytes in the 
operating system # s virtual storage pages. The default is 
PGSIZE=2048 * 


| {PLI | PL1) = {NO | YES} 

specifies whether PL/1 programs are to be processed. The 
default is PLI=N0. 

NO 

indicates that no PL/I programs are to be processed. 
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YES 


indicates that PL/I programs are to be processed. 


| PLTPI= {NO | xx | YES} 

specifies a program list table, which contains a list of 
programs to be executed after system initialization processing. 
The default is PLTPI=NO. 

NO 

indicates that the facility is not provided, 
xx 

indicates a one— or two-character suffix to specify which 
program list table is to be used. 


| YES 

| indicates that an unsuffixed PLT will be loaded. 


| PLTSD={NO|xx|YES} 

specifies a program list table that contains a list of programs 
to be executed during system termination. The default is 
PLTSD=NO* 

NO 

indicates that the facility is not provided, 
xx 

indicates a one— or two—character suffix to specify which 
program list table is to be used. 


| YES 

| indicates that an unsuffixed PLT will be loaded^ 


| PPT= ({YES | XX} , {COLD | WARM | HOT}) 

| processing program table suffix — see Notes 2 and 3 at the 

beginning of the description of this macro. In addition, the 
HOT option may be specified in this entry to indicate that the 
facility may be HOT started by using the information saved by 
the keypoint program (KPP) in a warm keypoint, which is read at 
system initialization. 


PRGDLAY=hhmm 

indicates the BMS purge delay time interval that is added to 
the specified delivery time to determine when a message is to 
be considered undeliverable and therefore purged. This time 
interval is specified in the form ,l hhmm ,f (where w hh ,,M 
represents hours from 00 to 99 and ,l mm 11 represents minutes from 
00 to 59). If PRGDLAY is not specified, or is given a zero 
value, a message will remain eligible for delivery either until 
it is purged or until temporary storage is reinitialized. The 
PRGDLAY facility requires ROUTING=YES and PAGING=YES to be 
generated in DFHSG PROGRAM=BMS. 

Note that the PRGDLAY value determines the interval between 
terminal page clean-up operations. A very low or zero value 
will prevent other tasks from executing, and a zero value will 
inhibit the terminal page clean-up operation. The actual purge 
delay time interval specified is dependent on individual system 
requirements. 
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PRINT={NO|YES|PA1|PA2|PA3} 

specifies methods of requesting 3270 printout. The default is 
PRINT=NO. 

NO 

specifies that print support is not required. 

YES 

specifies that the support required is limited to terminal 
control print requests. 

PA1, PA2, or PA3 

specifies that support is to be provided for the terminal 
operator print request via the specified program attention 
key as well as the terminal control print request. 

The 3270 print—request facility allows either the application 
program or the terminal operator to request a printout of data 
currently displayed on the 3270 display. This facility is not 
supported for TCAM devices* 

For a BTAM 3270 display, the PRINT request will print the 
contents of the display on the first available print—reguest— 
eligible 3270 printer on the same local or remote 3270 control 
unit. For a printer to be considered available, it must be in 
service and not currently attached to a task. For a printer to 
be considered print—request-eligible, it must be on the same 
control unit, have a buffer capacity equal to or larger than 
the 3270 display, and must have FEATtJRE=PRINT specified in its 
terminal control table terminal entry. 

For a VTAM 3270 display without the printer—adapter feature, 
the PRINT request will print the contents of the display on the 
first available 3270 printer specified by PRINTTO and ALTPRT in 
DFHTCT TYPB=TERMINAL (the PRINTTO printer is tested for 
availability first). For a printer to be considered available, 
it must be in service and not currently attached to a task. It 
is not necessary for the printer ro be on the same control 
unit, or to have FEATURE =PRINT specified in 0FHTCT 
TYPE=TERMINAL• 

In an MRO environment, the printer must be owned by the same 
system as the VTAM 3270 display. 

For the 3275 with the printer-adapter feature, the PRINT 
request will print the data currently in the 3275 display 
buffer on the 3284 Model 3 printer attached to the 3275. This 
operand is valid for both BTAM and VTAM support. 

The format of the print operation will be dependent upon the 
size of the display buffer. For a 40-character wide display, 
the print format will be a 40-byte line, and for an 80- 
character wide display the format will be an 80—byte line ^ 

For the 3270 compatibility mode logical unit of the 3790 (if 
the logical unit has the printer-adapter feature specified), 
the PRINT request will print the contents of the display on the 
first printer available to the 3790. The allocation of the 
printer to be used is under the control of the 3790. PRINTTO 
and ALTPRT are available for 3270 compatibility mode logical 
units. 

For 3274, 3276, and L0TYPE2 logical units, the PRINT request 
will print the contents of the display on the first printer 
available to the 3270 control unit. The printer to be 
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allocated depends on the printer authorization matrix. For 
further information, refer to the 3270 Inform a tion Display 
System Component Description manual. 

For the 3270 compatibility mode logical unit without the 
printer-adapter feature, see the preceding paragraph on VTAM 
3270 displays without the printer-adapter feature. 

Notes : 

1. A program attention key specified by this operand must not 
also be specified by the TASKREQ operand of the PCT or be 
used for 3270 single keystroke retrieval. 

2m When either YES, PA1, PA2, or PA3 is specified, an 

application program (DFHP3270) is generated, the name of 
which must be entered in the PPT. This program is invoked 
as a transaction (CSPP) which must be entered in the PCT. 
In the case of 3270 and LUTYPE2 logical units, the 
application programs DFHEXI, DFHCPY (transaction name 
CSCY), DFHPRK (transaction name CSPK) are generated. The 
names of these application programs must be entered in the 
PPT and the transaction names in the PCT * 


| RLR= {YES | xx} 

route list resolution (3MS) suffix — see Note 2 at the 
beginning of the description of this macro* 


SCP={YES|xx} 

storage control program suffix — see Note 2 at the beginning of 
the description of this macro. 


| SCS=( 300 1 decimal-value} 

specifies the number of bytes that are to be reserved for the 
storage cushion. The default is SCS=500. The range is 20 to 
524288. This value will be rounded up to the operating 
system B s next higher virtual page size (see the PGSIZE 
operand.) 


| SIM0DS= (A1,B1.C1.P1,B1,F1,G1.H1,I1,J1 1 phase} 

specifies the sequence of execution and names of system 
initialization overlays. The system initialization overlays 
are seven—character names in the format DFHSIxy, where x is a 
letter between A and Z and y is a number between 1 and 9. If 
additional user—written overlays are added, the CICS/VS— 
supplied user overlay sequence should not be altered. Any 
number of user—written overlays can be interspersed among the 
CICS/VS-supplied ones, and will be called in the sequence they 
are specified in the SIMODS parameter. However, the CICS/VS— 
provided overlay (DFHSIJ1) must be the last overlay specified. 
Users should be aware that the sequence names and number of 
| CICS/VS-suppliad system initialization overlays may change. 

The default is SIM0DS=(A1,B1,C1,D1,E1,F1,G1,H1,11,J1). 

Note: Only those system initialization overlays that are 

identified in the sequence list (whether CICS/VS-supplied or 
user-written) will be loaded. 


220 


CICS/VS System Programmer^ Reference Manual 



SKRxxxx=*page—retrieval—command 1 

defines a single—keystroke—retrieval operation, xxxx specifies 
a key on the 3270 keyboard which, during a page retrieval 
session, is to be used to represent a page retrieval command. 
The valid keys are PA1 through PA3, and PP1 through PF24. Thus 
up to 27 keys can be specified in this way (each by a separate 
command). 

If one or more keys are to be used to initiate a page retrieval 
session, and therefore dedicated to page retrieval operation, 
an entry for each key must be included in the program control 
table (see Appendix A). 

•page—retrieval-command* represents any valid page retrieval 
command. It will be concatenated to the character string 

specified in the PGRET operand. The combined length must not 

exceed 16 characters. 

I Rote : If BMS is generated for single—keystroke—retrieval 

| (SKR3270=YES specified in DFHSG PR0GRAM=BMS) , then all PF keys 

| are reserved for page retrieval commands, even if they are not 

j all defined. 


SRP= (YES t XX} 

system recovery 
the description 


program suffix — see Note 2 at the beginning of 
of this macro. 


SRT-fYBSI NO| xx} 

system recovery 
the description 


table suffix — see Note 2 at the beginning of 
of this macro. 


Note : Specifying SRT=N0 forces the dummy version of the system 

recovery program (SRP) to be loaded. The full version of the 
SRP provides recovery code in program check and abnormal 
termination situations. The dummy SRP does neither, although 
it does issue SPIE (OS/VS) or STXIT PC (DOS/VS) macros to 
intercept program checks to perform clean—up operations before 
CICS/VS goes down. Therefore, an SRT must be provided if 
recovery from program checks and/or abnormal terminations is 
reguired. 


| SRT=N0 must not be specified if intercommunication facilities 

I are to be used for CICS/DOS/VS* 


START= {COLD | WARM} 

specifies the type of start for the system initialization 
program. The value specified for START, or the default of 
COLD, becomes the default value for each of the other 
facilities containing the COLD and WARE parameters unless 
specified in the individual entries. 

COLD 

indicates a cold start. 

WARM 

indicates a warm start. 

Note: Emergency restart is invoked by specifying START=EMER or 

START=(EMER,ALL) as system initialization override parameters. 
For further information, refer to the appropriate CICS/VS 
System Programmer*s Guide (DOS/VS or OS/VS). 
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S VD= {NO|YES|nn} 

indicates whether a storage violation dump is required in order 
to assist the user in identifying the cause of a storage 
violation. The default is NO* 

NO 

indicates that a storage violation dump is not reguired. 

YES 

indicates that a dump is required each time a storage 
violation occurs. 


nn 

| indicates the numner of times (0 through 99) a storage 

violation dump is to be taken for each occurrence of a 
storage violation. 

Note : If storage violation dumps are required, RECOVERIES 

must be specified in DFRSG PROGRAM =SCP and the DFHSIT macro 
must not include FDP=N0. 


| TCP= fYSS | xx | NO} 

specifies the suffix to be appended to the name of that portion 
of the terminal control program which supports start—stop, BSC, 
TCAM, and TCAM SNA devices* See Note 2 at the beginning of the 
description of this macro* 

Note s The system programmer should be aware that ZCP does not 
default to the same suffix as that specified for TCP. An 
unsuffixed ZCP module is loaded. 


| TCT= ({YES | XX} , {COLD | WARM} ) 

| terminal control table suffix — see Notes 2 and 3 at the 

beginning of the description of this macro. 


| TDP= {YES | xx} 

transient data program suffix — see Note 2 at the beginning of 
the description of this macro. 


| TPP= fYES IXXl 

terminal page program (BMS) suffix — see Note 2 at the 
beginning of the description of this macro. 


| TRP= ({YES |xx} , 10NI0FFIADX} ) 

indicates whether the trace control facility is required. The 
module may be suffixed, and, in addition, the ON, OFF, and AUX 
options may be specified. 


The trace control facility can be turned off at start-up time 
either by a system initialization table parameter {see examples 
that follow), a system initialization override parameter, or 
through the master terminal facilities of CICS/VS. This will 
still allow for debugging facilities if needed, by dynamically 
turning trace on either in an application program or through 
the master terminal facility. 
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Examples: 


TRP=AB 
TRP= (AB,AUX) 
THP= (AB,OFF) 
TRP= (,OFF) 


Trace control program 
trace on (by default) 
Trace control program 
auxiliary trace on 
Trace control program 
initialized off 
Trace control program 
trace initialized off 


suffix AB with 
suffix AB with 
suffix AB with trace 
unsuffixed with 


Note: The trace control program will not be entered or 
referenced if trace is turned off, even though full trace 
facilities are available. In terms of processor cycles or 
storage reference patterns, there is no advantage in specifying 
a dummy trace program. 


| TRT= {0 |decimal—value} 

specifies the number of entries that are to be provided in the 
CICS/VS trace table. If this parameter is 0, a dummy trace 
facility is loaded (DFHTRPDY)• The default is TRT=0. The 
range is 0 to 10000. See the discussion on trace—table entries 
in Example 1 of the nucleus load table earlier in this chapter. 


| TSMGSET= {41 number} 

specifies the number of entries for which dynamic storage will 
be allocated for storing pointers to records put to a temporary 
storage message set. When the n entries are used, space is 
acquired for n more entries as many times as required to 
accommodate the total number of records in the queue at any 
point in time* The default is TSMGSET=4. The range is 4 to 
100* For further information on temporary storage message set 
entries, refer to the CICS/VS System/Application Design Guide . 


| TSP= ({YES|XX} ,{COLD|WARM} ) 

| temporary storage program — see Notes 2 and 3 at the beginning 

of the description of this macro. 


TST= {NO IYES|xx} 

specifies whether the temporary storage table is to be 
| included.The default is TST=N0* 

NO 

indicates that no TST is required* 

YES 

| indicates that the TST is to be included, 

xx 

indicates the 2-character suffix appended to DFHTST. 


| WRKAREA= f5121 number} 

| specifies the number of bytes to be allocated to the common 

work area portion of the CSA. This area is for use by the 
installation, is initially set to binary zeros, and is 
available to all programs. It is not used by CICS/VS. The 
maximum size for the work area is 3584 bytes. The default is 
512 bytes* 
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| XLT= {NO|XX|YES} 

specifies a suffix for the transaction list table. The table 
contains a list of transactions that can be attached during the 
first guiesce stage of system termination. The default is 
XLT=NO. See Note 2 at the beginning of the description of this 
macro. 


| XSP={NO|YES|xx} 

| CICS/VS external security program suffix — see Notes 2 and 4 at 

| the beginning of the description of this macro. 


| XTP={NO|YES|xx} 

| transaction routing transformer program — see Note 2 at the 

| beginning of the description of this macro. If the XTP operand 

| is specified, it overrides the specification in the ISC 

| operand. 


| ZCP= {YES | xx} 

specifies the suffix of the ZCP, ZCB, ZCZ, and ZCX modules that 
are to be loaded by SIP. The default is ZCP=YES (an unsuffixed 
| module). See Note 2 at the beginning of the description of 

| this macro. 


CICS/DOS/VS O nly 


FERS={YES|NOfALL} 

indicates the level of support to be provided for the facility 
error recognition system (PEES) for recording information on 
errors that occur on BTAM lines and terminals under 
CICS/DOS/VS. The facilities of FEES are provided in response 
to transaction CSFE being specified in the program control 
table. The default is FERS=YES. Further details on this 
facility"' 1 can ne found unoer transaction CSFE in the CICS/VS 
Operators Guide . 

YES 

indicates that the full FEES function is to be used, with 
the exception that the dialing character for a remote 
terminal will not be displayed (as a security measure). 

NO 

indicates that the FEES facility is not reguired. 

ALL 

indicates that all the facilities provided by FEES are 
reguired. This involves logging errors onto CICS/VS 
temporary storage and providing the user with the ability 
to display more detailed information on where an error 
occurred and the type of error that was detected* 
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| ICVSWT={40|decimal—value} 

indicates the period of time after which CICS/DOS/VS regains 
| control from VSE to check for completion of a disk I/O request 

made by a transaction. 

A disk I/O normally takes between 20 and 40 milliseconds to 
complete. If a very low "short wait" interval is set, 
unproductive processing may be caused; a high value may cause 
an unnecessary increase in response time. The range is 0 
through 1000 milliseconds, with a default value of 40 
milliseconds. The actual value chosen is dependent on the 
requirements of the individual system. 

Note: CICS/DOS/VS will only take as long as the period 
specified in the short wait interval to detect the completion 
of a disk I/O if there is no other activity in the CICS/VS 
system. Therefore, in a high activity system, the short wait 
value should be set to a low value if it is to have any 
| noticeable effect. If ICVSWT=0 is specified, the VSE WAIT 

macro will not be issued whenever disk I/O is in progress. A 
value of 0 should only be used after careful consideration of 
the effect it may have on batch partitions. 


| NSD={01 number} 

specifies the maximum number of nonsequential disk extents that 
will exist for any data set involved in the execution of 
| CICS/DOS/VS. The default is NSD=0. 

CICS/VS system initialization uses the NSD value to determine 
the amount of storage to be reserved at the beginning of the 
partition for label processing when the data sets are opened. 
Although most data sets are opened during system 
initialization, the dynamic open/close feature of the CICS/VS 
master terminal program may need to use this label processing 
area during the execution of CICS/VS* The presence of this 
| operand makes it unnecessary for the user to supply a VSE 

| LBLTYP job control statement with the CICS/VS execution deck. 


C ICS/OS/VS Only 


| BUFPL= {8 | number} 

| this operand appears only for compatibility with previous 

| releases of CICS/VS. 

| The BUFPL operand has no effect when IMS/VS Version 1.1.5 is 

| used with CICS/VS Version 1, Release 5* IMS/VS uses the value 

| in the IOBF parameter on the DFSVSAHP options card for ISAM and 

| OSAM, and the values on the DFSVSAMP subpool definition 

| statement for VSAM. 


| DDIR={YES| XX} 

specifies a suffix for the DDIR list and is applicable only if 
| the CICS/OS/VS—DL/I interface is to be used. The default is 

| DDIR=YES. 
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I DLTHRED=Q|number} 

specifies the number of strings (1 to 15) provided through the 
DL/I interface, and is applicable only if the CICS/OS/VS—DL/I 
interface is to be used. The default is 1. The value 
specified in this operand must be large enough to accommodate 
the online DL/I usage plus the shared data base requirements; 
that is, a number of threads equivalent to the number specified 
in the SESNUMB operand in the DFHTCT TYPE=IRCBCH macro. 


| DMBPL={4| number} 

applicable only if the CICS/OS/VS—DL/I interface is to be used, 
this operand specifies the data management block (DMB) pool 
size in 1024—byte blocks for CICS/OS/VS—DL/I interface support. 
The number of 1024-byte blocks specified must be in the range 0 
to 999. The default is DMBPL=4. 

This operand corresponds to the DMB operand of the IMS/VS 
BUFPOOLS system definition macro instruction and to the JJJ 
parameter of the IMS/VS CTL or CTX parameter list for online 
execution * 


| ENQPL= {2 |number} 

indicates the maximum size (in K bytes) to be allocated by 
IMS/VS for ENQ control block space* ENQ control blocks are 
heavily used when program isolation scheduling (PISCHD=YES) is 
to be used for DL/I transactions. This parameter is identical 
to the second sub—parameter of the CORE operand of the IMSCTF 
macro, and is provided in CICS/VS because the IMSCTF macro is 
not available for IMS/VS DB users. The range is 0 through 999, 
with a default value of ENQPL=2 * 

For further information on how to calculate the ENQPL value, 
refer to the IMS/VS System Programmers Reference Manual . 


| IOCP={0(number} 

specifies the percentage of DASD I/O events that the task 
control program will wait on* The value of IOCP may be from 0* 
to 50%. (0% is a wait count of one, and 50% is a wait count 

equal to half the number of outstanding DASD I/O events.) The 
default is IOCP=0. 


LPA= {NO | YES} 

indicates whether any CICS/VS management modules may be used 
from the OS/VS link pack area. The default is LPA=MO. 

NO 

indicates that no CICS/VS management modules will be used 
from the link pack area* 

YES 

indicates that some CICS/VS management modules may be used 
from the link pack area instead of being loaded into the 
CICS/VS partition. Nucleus modules to be used in this way 
must have SHR=YES indicated in the nucleus load table. No 
support is provided for the use of PPT programs from the 
link pack area. 

For further details on the SHR operand of the DFHNLT macro 
and the use of the CICS/VS supplied default nucleus load 
table with LPA=YBS in effect, refer to the DFHNLT macro 
description in this chapter. 
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| A list of the CICS/VS nucleus modules which are read-only, 

| and hence eligible for residence in the link pack area, can 

| be found in the CICS/VS System Programmers * Guide (OS/VS) . 

| together with details of a start—up parameter, PRVMOD, for 

| overriding the SHR=YES specification in DFHNLT for selected 

| modules. 


| OSCOR={81221 decimal-value} 

specifies a one— to eight—digit decimal value in the range 0 to 
| 16777215 (or 2 2 *—1) bytes, which indicates the number of bytes 

of storage to be provided from the CICS/OS/VS partition or 
region for the use of the operating system during CICS/OS/VS 
execution. The minimum amount of storage available to the 
operating system is equal to the size of the system 
initialization program (DFHSIP) . The default is 0SC0R=8192. 

If the value specified is greater than the size of DFHSIP, the 
amount of storage provided for the use of the operating system 
is equal to the size of DFHSIP plus the amount specified in 
excess of the size of DFHSIP* Note that this storage is not 
available to the operating system until DFHSIP transfers 
control to the dummy CSA program (DFHDCSA) . 

The user should be aware that an incorrect OSCOR specification 
could adversely affect system performance. The value specified 
should accurately reflect the amount of address space required 
by the operating system, depending upon the CICS/VS 
| configuration. If, for example, ACF/VTAM is used, a higher 

OSCOR value will be required. 

| The OSCOR requirements for interregion communication (MRO and 

| DL/I shared data base) are as follows: 

| • For OS/VS1, the partition local storage requirement (to be 

| included in OSCOR) is 

| IK + (100 * N) bytes 

| where N is the number of SEND and RECEIVE sessions defined 

I in this system^s TCT; (Add together all SEND and RECEIVE 

| values in all TYPB=SYSTEM entries). 

| Also, the storage requirement in subpool 241 is 

| IK + (10 * M) bytes 

| where M is the sum of all the N , s (as defined above) for 

I all the active CICS/VS systems. 

| • For MVS the address—space local storage requirement is 

| (60 * N) bytes 

| where N is as defined above for 0S/VS1. 

| The MVS CSA storage requirement is 

| (IK * P) + (50 * M) + transfer buffer storage bytes 

| where P is the number of active IRC CICS/VS systems, and M 

| is as defined above for OS/VS1i 

I The transfer buffer storage requirement is the amount of 

| storage used to hold data being sent between IRC systems 
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(CICS/VS MHO or CICS/VS and batch shared data base). This 
depends on the amount of data in transit at peak IBC 
traffic. As a guide, the maximum value can be calculated 
as follows. 

For 3270 transaction routing: 

(3270 data stream size +50) * (maximum number of 
concurrent tasks in the system using IRC) bytes 

For file control function shipping: 

(file record size + 50) * (maximum number of concurrent 
tasks in the system using IRC) bytes 

For shared data base: 

((max. segment or path size) + (max. SSA size * number 
of SSAs) 

♦ (max. number of concurrent batch address spaces using 
shared data base) bytes 

OSCOR is free address space within the CICS/VS region or 
partition, which may be acquired by the host operating system 
(0S/V$1 or MVS) GETMAIN requests. CICS/VS itself, once 
initialized and running, does not issue host operating system 
GETMAINs, but directs all address space requests to the CICS/VS 
storage control program which satisfies those requests from a 
preallocated address space known as the CICS/VS dynamic storage 
pool. However, the host operating system or services of the 
host operating system used by CICS/VS may cause host operating 
system GETMAIN requests on behalf of CICS/VS. Some of the 
reasons for these storage requests are: 

BDAM dynamically acquires IOBs and read-exclusive lists. 

The file control program, the transient data program, and 
the keypoint program all use BDAM. 

BDAM will acquire IOBs for each I/O request; therefore 
there will be as many IOBs and segments on the read- 
exclusive list as there are concurrent I/O requests. The 
number of concurrent BDAM I/O events would normally not 
exceed the MXT (maximum tasks) value. 

ISAM dynamically acquires IOBs for I/O requests. The file 
control program may use ISAM. 

ISAM will acquire IOBs for each I/O request, READ, READ 
UPDATE, or WRITE KN. However, READ UPDATE IOBs are saved 
and used for WRITE UPDATE requests before being released. 

VTAM will acquire storage from the CICS/VS partition in 
order to satisfy connection requests such as OPNDST, CLSDST 
and SIMLOGON. Reguests are issued as a result of, for 
example, CONNECT=AUTO being specified in DFHTCT 
TYPB=TBRMINAL, a terminal logon, and the use of the master 
terminal ACQUIRE command* 

Figure 8*3—3 in Chapter 8.3 provides guidance on how to 
calculate an appropriate OSCOR value for the major access 
methods. 
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Use of dynamic OPEN/CLOSE in CICS/VS will significantly 
increase the amount of OSCOR used, OPEN requests may cause 
acquisition of the following areas: 


I 


• 10 Bs 

• Channel programs 

• Buffers (extrapartition transient data) 

• Work areas (ISAM) 

• Additional control blocks (such as VSAtt buffers) as 
determined by the access methods used and the 

host operating system 

• Depending on the host operating system, access methods 
may also be loaded in OSCOR 

CLOSE requests may cause address space of the types 
acquired by OPEN requests to be released and made available 
as OSCOR. 

In addition to the size requirements of OSCOR, additional 
area should be allocated to allow for fragmentation which 
will result from intermixed host operating system GETMAIN 
and FREEMAIN requests of varying size. At least an 
additional 20 to 30 percent should be allowed in OSCOR 
estimates for fragmentation. 

For information concerning host operating system control 
block address space requirements, refer to the specific 
operating system reference manuals, such as the 0S/7S1 
Storage Estimates manual* 


| PDIR={YES |xx} 

specifies a suffix for the PDIR list and is only applicable if 
| the CICS/OS/VS—DL/I interface is to be used. The default is 

| PDIR=YES. 


PISCHD={NO|YES} 

indicates whetner program isolation scheduling (PISCHD=YES) or 
segment intent scheduling (PISCHD=N0) is to be performed for 
transactions that access DL/I data bases. The PCT entry for 
transactions that use program isolation scheduling should 
include DTB=YES and, optionally, RESTART=YES so that a 
transaction that fails can be backed out dynamically and 
restarted automatically after such conditions as a transaction 
deadlock. The default is PISCHD=N0. Further details on 
program isolation scheduling can be found in the CICS/VS 
System/Application Design Guide . 


PLISHRE= {NO | YES} 

specifies whether PL/I shared library support is to be 
included. The default is NO. 
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| PSB=CICSPSB|name 

applicable only if the CICS/OS/VS—DL/I interface is to be used, 
this operand is used to specify the one— to eight—character 
name of the program specification block (PSB) used during 
IMS/VS initialization. This PSB contains a program 
communication block (PCB) for each DL/I access method to be 
used (two PCBs in the case of HISAM), and is used to load all 
required DL/I modules during initialization. The default is 
PSB=CICSPSB. 

The PSB operand is not applicable, and may be omitted, in the 
case where there are no data bases that are resident on the 
CICS/OS/VS system. This situation arises when all DL/I 
requests from the CICS/OS/VS system are for data bases that 
reside on remote CICS/OS/VS systems (and are accessed through 
the intersystem communication facility). 


| PSBPL= (41 number) 

applicable only if the CICS/OS/VS-DL/I interface is to be used, 
this operand specifies the program specification block (PSB) 
pool size in 1024—byte blocks for CICS/VS—DL/I interface 
support. The number of 1024—byte blocks specified must be in 
the range 1 to 999. The default is PSBPL=4. 

This operand corresponds to the PSB operand of the IMS/VS 
BUFPOOLS system generation macro instruction and to the III 
parameter of the IMS/VS CTL or CTX parameter list for online 
execution. 


| XPSB-{CICSPSB|name) 

| indicates the seven—character name by which PSBs are grouped in 

| the resource access control facility (RACF) under MVS. The 

| name is prefixed by Q. The default is XPSB=CIC5PSB. 


| XTRAN={CICSTRNJ name) 

| specifies the seven—character name by which CICS/VS 

| transactions are grouped in resource access control facility 

| (RACF) under MVS. The name is prefixed by G. The default is 

| XTRAN=CICSTRN. 


SNT — SIGN—ON TABLE 


The sign—on table provides a place for retaining terminal operator data 
permanently. It is accessed when a terminal operator initiates the 
sign—on procedure via the CSSN transaction. The sign—on table is the 
only table that cannot be suffixed. 

| During the sign—on procedure, the operator enters a name at the 
| terminal and this is used to locate the appropriate operator entry in 
the sign—on table. The operator entry in the table contains data used 
to verify the operator name and to establish a priority and a security 
| key for the transactions that the operator subsequently enters. The 
I priority key values replace the values that have already been specified 
| in the DFHTCT TIP£=TERMINAL macro. 

The priority value assigned to the operator is used to develop the 
task priority for processing a transaction. The operators security key 
is used in a security check of all transactions subsequently entered. 
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The security key is matched with the transaction security value 
contained in the transaction*s program control table (PCT) entry. 

If the operator security key contains any value that matches the 
transaction security value in the PCT entry, the transaction is 
accepted. Otherwise, a security check occurs and the transaction is 
terminated. A security key of 1 is the default option in the creation 
of the sign—on table, the program control table, and the terminal 
control table. The security key default option allows transactions with 
a transaction security of 1 to be entered into the system by the 
operator without the sign-on procedure. 

The resource security level (RSL) key is used to control access to a 
resource, such as an entry in the PCT. The RSL value specified in the 
resource table is compared with the values assigned to the operator in 
the SNT, and access to the resource is allowed if a match is found. The 
default RSL value is zero* Resource level security checking can be 
reguested for any transaction using the command level interface and is 
requested by default for the EXEC interpreter, EDP, and the mirror 
transaction when generated using the DFHPCT TYPE=GROUP macro 
instruction. 

If an entry in the SET has EXTSEC=YES specified then an external 
security manager will be used to check the operators name and password. 

The sign-on table macro instruction (DFHSNT) specifies the terminal 
operator data for the users of CICS/VS. A DFHSNT entry should be 
present in the sign-on table for each terminal operator who is expected 
to sign on. 

The sign-on table must be assembled, link-edited with the name 
DFHSNT, and represented in the processing program table (PPT). 


CONTROL SECTION — DFHSNT TYPE=INITIAL 


The control section into which the sign-on table is assembled is 
established by the DFHSNT TYPE=INITIAL macro instruction, which must be 
coded as the first statement in the source deck used to assemble the 
sign—on table. 

i -—«- 1 -■--- 1 

| | (DFHSNT | TYPE=INITIAL * | 

II | | [ ,EXTSEC = {NO|YES) I 

i_i_i-1 

| * See the first page of this chapter. 


| EXTSEC= {NO | YES} 

| indicates whether an external security facility is to be used 

| instead of the CICS/VS—provided security facilities for all 

I entries in the sign-on table. The default is EXTSEC=NO. 


I 

I 

I 


indicates that only the CICS/VS—provided security 
facilities are to be used. 




YES 

indicates that an external security facility (for example, 
RACF under MVS) will be used. EXTSEC=YES must also be 
specified in DFHSIT* 
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| TERMINAL OPERATORS - DFHSNT TYPE=ENTRY 

I 

| Each terminal operator is described to CICS/VS through entries in the 
| sign—on table. These entries are made by issuing the DFHSNT TYPE=ENTRY 
| macro instruction as follows: 


1 r.— 

i- 

“i- 

-j 

i i 

(DFHSNT 

| TYPE=ENTRY 


i 

i 

j ,0PIDEHT=operator—identification 


i 

i 

| ,0P»AME=*operator—name* 


i i 


| [ ,EXTSEC={NO|YES} 


i 


| [ ,NABPORM=DEC] 


i 


| [ ,OPCLASS=ai (n1[ ] 


i 


| [,0PPRTY={0|number}] 


i i 

i 

| [ ,PASSHRD=password] 


i i 

i 

| [ ,RSLKEY=(n1[ ,n2] 


i 

i 

| [ ,SCTYKBY=UI (»1[#n2 ] 


i_ 

i_ 

_i_ 

t 


| TYPE=BNTRY 

| creates an entry for each terminal operator in the sign—on 

| table. 


OPIDENT=operator—identification 

specifies the one— to three-character operator identification 
code assigned by the system administrator to each operator. 
This code is placed in the appropriate terminal control table 
terminal entry (TCTTB) when the operator signs on so that the 
identity of the operator is known to CICS/YS. This operator 
identification is made available to the master terminal when a 
security violation is detected. 


OPNAME=•operator—name• 

specifies the name of the terminal operator for this table 
entry. The operator name: 


I 

I 

I 

I 


• May oe 1 to 20 characters long and must be unique for each 
entry. 

• May not terminate with a blank* 

• Must be matched exactly by the operator name entered in the 
sign—on procedure. The operator name may be enclosed 
within single quotes at sign—on. 

• May contain apostrophes* Two single quotes must be 
substituted for each apostrophe, and these will be 
translated by the assembler. 

• For the 3741 operator identification reader only, the 
operator name can consist of up to 40 decimal digits, which 
must match the string recorded on the operator 
identification card. 


| EXTSEC= {NO | YES} 




indicates whether an external security facility is to be used 
instead of the CICS/YS-provided security facilities for this 
entry in the sign-on table. If this operand is omitted, the 
EXTSEC value is taken from that specified in the DFHSNT 
TYPE=INiriAL macro instruction. 
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indicates that only the CICS/VS-provided security 
facilities are to be used. 


YES 

indicates that an external security facility (for example, 
RACE under MVS) will be used* EXTSEC=YES must also be 
specified in DFHSIT. 


NAMFORM=DEC 

indicates that the sign-on data is expected from the operator 
ID reader of a 3741 terminal* The operand causes the data 
| specified in the OPNAME parameter to be represented in packed 

| decimal format, and the PASSWRD operand to be ignored. 


OPCLASS={H <a1[ #n2 ],...)} 

| specifies one or more decimal values in the range 1 to 24, 

I which identify the operator classes to which 3MS messages will 

| be routed. The default is 0PCLASS=1. 

| The operator class for a terminal operator consists of those 

| values that must match an internally initiated task request 

| value before the task will be initiated. Each decimal value 

specified in this operand has a corresponding bit position in a 
three-byte operator class field in the sign—on table entry 
which is placed in the TCTTE when the operator signs on to the 
corresponding terminal. The presence of each value in the 
operand causes the corresponding bit position to be set to 1. 

N ote ; This operand is only required when the optional OPCLASS 
parameter in the DFHBMS TYPE*=R0UTE macro is also specified as a 
single numeric value from 1 to 24. The corresponding value 
must be specified in the OPCLASS parameter of the DFBSNT macro 
before automatic routing will occur. 


OPPRTY= (0 | number} 

specifies a decimal operator priority value from 0 to 255. An 
operator priority is assigned optionally by the user and is 
used in developing the task processing priority for each 
transaction. The default is 0PPRTY=0. 


I 


I 

I 


PASSWRD=password 

specifies an eight-character password created by the user. The 
password entered by a terminal operator as a part of the sign- 
on procedure must be matched exactly by the password in the 
operators sign-on table entry. Passwords may be unique to 
each operator or the same for a logical group of operators. 

This operand cannot be specified for entries that use the 3741 
operator identification reader. 


Chapter 3.2. Table Preparation 


233 




BSLKEY= (n1[ , n2 ], • • •) 

specifies one or more decimal security key values from 1 to 24. 
The resource level security key may be built with from 1 to 24 
individual values. Each decimal value, in the range 1 to 24, 
specified as the value for the RSLKEX operand has a 
corresponding bit position on a three—byte BSLKEY field. The 
presence of each value causes the corresponding bit position to 
be set on. 

The resource level security, defined by the RSL operand on the 
DPHDCT, DFHFCT, DFHJCT, DFHPCT, DFHPPT, and OFHTST macro 
instructions, is specified as only one of the possible 24 
values. The same value must be contained in the operator # s 
security key to allow access to the resource defined in the 
particular table concerned. The operator*s security key is not 
limited to one value. 


SCTYKEY*{1| (n1[,n2 ],...)} 

specifies one or more decimal security key values from 1 to 24. 
The default is SCTYKEY=1. The security key for a terminal 
operator comprises those values that are to be matched with the 
transaction security of an appropriate program control table 
entry. The security key may be built with from 1 to 24 
individual values. Each decimal value in the range 1 to 24 
specified in the operand of the SCTYKEY keyword has a 
corresponding bit position in a three—byte SCTYKEY field. The 
presence of each value in the operand causes the corresponding 
relative bit position to be set on. 

The transaction security defined by the TRANSEC operand in a 
program control table is specified as only one of the possible 
24 individual values. The same value must be contained in the 
operator's security key to allow the operator to process that 
transaction. The operator's security key is not limited to 
just one value. 


TERMINAL OPERATORS — DFHSNT TYPE = (ENTRY,DEFAULT) 


Sign-on data for terminal operators whose names cannot be found in the 
SNT when an external security facility, which can authorize them, is in 
force is supplied by the DFHSNT TYPE= (ENTRY,DEFAULT) macro. 


IDFHSNT | TYPE=(ENTRY,DEFAULT) 

I j ,OPIDENT=operator—identification 

| | [,NAMFORM=DBC ] 

| | [ ,0PCLASS=(l|n1[ ,n2 ],....)} ] 

| | [,0PPRTYS={0|number}] 

| | [ ,PASSRRD=password] 

| | [ ,SCTYKEY=Q|n1[ ,n2 ],....)} ] 

| | [ ,RSLKEY=(n1[,n2],*...) ] 
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| TYPE= (ENTRY,DEFAULT) 

I creates an entry with a blank operator name and a reference to 

| an external security facility in the sign-on table. When 

| DFHSHP scans the sign-on table and cannot find an entry for a 

j particular operator name, the external security manager 

| examines its files to see if the operator is allowed to sign 

| on. 

| The remaining operands are as described in DFHSHT TIPE=EHTBT. 


END OF SIGH-OH TABLE — DFHSHT TYPB=FIHAL 


The end of the sign-on table is indicated by the DFHSHT TYPE=FIHAL macro 
instruction, which is the last statement in the assembly of the sign-on 
table before the assembler END statement* This macro instruction 
creates a dummy entry to signal the end of the table. 


r 

I 


L 


I-•- 

IDFHSHT | TYPE=PINAL 


.1_t 


i 

I 

j 


TYPE=FINAL 

indicates the end of the sign-on table. 


EXAMPLE 


| Figure 3.2—14 contains an example of coding for the sign—on table. In 
this example, there are two cases where the operator names are actual 
names and one instance of the name being a function. The first operator 
has access to transactions whose transaction securities are 1, 2, 7, or 
24. The other two operators have access to the same transactions as the 
first plus additional transactions. The second operator has a default 
priority of zero. 


DFHSHT TYPE=IHITIAL 

DFHSHT TYPE=BHTRY, * 

OPNAME='DOH GIBSOH*, * 

| EXTSEC=YES, * 

| BSLKBY=(1,2,6,20) , * 

OPIDEHT=DG, * 

SCTYKEY=(1,2,7,24) , * 

0PPRTY=128 

DFHSHT TYPE=EHTRY, * 

OPHAME='R. J. JOBES', * 

PA SS HR D=DI ST , * 

OPIDEHT=RJJ, * 

SCTYKEY=(1,2,7,9,24) 

DFHSHT TYPE=EHTRY, * 

0PHAME='MASTER TBRMIHAL 1', * 

PASSWRD=MAST, * 

0PIDBNT=MT1, * 

SCTYKEY=(1,2,3,4,7,9,24) , * 

0PPRTY=255 

DFHSHT TYPE=FIHAL 

BHD 


| Figure 3.2—14* Sign-On Tanle — Example 
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SET - SYSTEM RECOVERY TABLE 


The system recovery table contains a list of abend codas that will be 
intercepted. It also contains the identification of logic to be 
executed in the form of either a user— or a CICS/VS-supplied routine. 

The following macro instructions may be specified in a system 
recovery table: 

• DFHSRT TYPE=INITIAL - to establish the control section 

• DFHSRT TYPE=SYSTEM|USSR - to specify the abend codes that are to be 

handled 

• DFHSRT TYPE=FINAL — to conclude the system recovery table. 


CONTROL SECTION — DFHSRT TYPE^INITIAL 


The DFHSRT TYPE=INITIAL macro instruction 
table control section. 

i ... ■ i i 

| | IDFHSRT | TYPE=INITIAL 

| | | | [,SUFFIX=xx] 

i-1-1_ 

| * See the first page of this chapter. 


generates the system recovery 


* I 

* I 


ABEND CODES - DFHSRT TYPE=SYSTEM/USER 

The DFHSRT TYPE=SYSTEM|USER macro instruction is used to specify abend 
codes in the system recovery table. 


-!- 

DFHSRT | TYPE={SYSTEM|USER} 

j , A3C0DE= (abend-code,...) 

| [,PROGRAM=program—name]|[,ROUTINE=name] 


TYPE= {SYSTEM J USER} 

indicates the type of abend code to be intercepted. The 
default is TYPE=SYSTEM. 

SYSTEM 

identifies the abend code as an operating system abend 
code. 

USER 

identifies the abend code as a user (including CICS/VS) 
aoend code. This option applies to CICS/OS/VS only. 
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ABCODE= (abend—code , ...) 

identifies the abend code (or codes) to be handled by the 
routine identified by this macro definition. VSE codes are 
contained in VSE/Advanced Functions Macro Reference in the 
discussion of the STXIT macro instruction. For example, code 
30 indicates an abend because an attempt was made to read 
beyond a /& statement. 


P ROG R A M =p rog r a m—na me 

identifies the program name to be given control when this abend 
is encountered. The name specified by this parameter must be 
in the PPT* 


BOUT IDE 35 name 

identifies the resident routine to be given control when the 
abend is encountered. A routine is either a separately linked 
module or a routine coded in-line in the SRT* If it is a 
separately linked module, its name need not be in the PPT since 
a V—Type ADCON is set up in the SRT. If it is coded in-line, 
the routine must be placed after the DFHSRT TYPE=FINAL 
statement* The name specified must appear in either a CSECT or 
ENTRY statement in the routine. 


Notes; 


1. PROGRAM and ROUTINE are mutually exclusive. 

2* A routine is supplied and generated in the system recovery table, 
which intercepts selected system abend codes (shown in the 
following lists) and attempts to keep CICS/VS operational by 
disabling a resource and/or causing the offending task to abend. 

If the user wishes to supply his own routine for these abend codes 
or not to attempt recovery, he may so indicate by coding a DFHSRT 
macro for those abend codes. If an abend code or a group of abend 
codes is specified without the PROGRAM or ROUTINE parameters, no 
recovery will be attempted should one of those codes occur, and 
CICS/VS will be terminated. 

The following 0S/VS abend codes will be intercepted and recovery 
will be attempted under the CICS/VS—supplied recovery routine: 


001,002,013,020,025,026,030, 

032,033,034,035,036,037,03A, 

03B,03D,100,113,117,213,214, 

237,313,314,337,400,413,437, 

513,514,613,614,637,713,714, 

737,813,837,913,A13,A14,B13 
B14,B37,D23,D37,B37 

In addition, with MVS, abend code 0F3 will be intercepted and 
recovery attempted. This abend code covers various machine check 
conditions. It also covers the Alternate Processor Retry (ACR) 
condition which can only occur when running on a multiprocessor. 
CICS/VS—supplied recovery code will attempt to recover from 
instruction—failure machine checks on the assumption that they are 
not permanent. It will also attempt to recover from ACR 
conditions. 
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| The following VSE abend codes will be intercepted and recovery will 

be attempted under the CICS/VS-supplied recovery routine: 


13,1A,IB,21,22,25,26,27,2B, 

30,32,33 

To obtain recovery for the abend codes above, the DFHSRT macro 
instruction can be specified as follows: 


DFHSRT TYPE=INITIAL 
DFHSRT TYPE=FINAL 

3. If the user wishes to have the CICS/VS—supplied routine handle 
other errors, he can code the DFHSRT macro instruction as follows: 

DFHSRT TYPE=SYSTEM,or USER, 

ABCODE=(user or system codes), 

ROUTINE=DFHSRTRR 

4. Abend recovery is based on CICS/VS—supplied functions; therefore, 
users should be aware that modifications to CICS/VS—supplied 
programs and nucleus modules, or operating system macros issued by 
application programs capable of causing an abend, will not be 
recovered by CICS/VS. For these cases, additional logic should be 
added to the recovery routine or a user-supplied routine should De 
provided. 


END OF SYSTEM RECOVERY TABLE — DFHSRT TYPE=FINAL 


The macro instruction used to specify the end of the system recovery 
table is: 


r 

I 

L 


i-r- 

(DFHSRT | TYPE=FINAL 


L 


L 


T 

I 

J 


TYPE=FINAL 

indicates the end of the system recovery table. Any inline 
routines and the assembler END statement must follow this 
statement. 

For information concerning the creation of the PROGRAM or ROUTINE to 
handle abends in connection with the system recovery table, see 
••Creating a System or User Abend Exit” in Chapter 4.5 of this manual. 


EXAMPLE 


| Figure 3.2—15 illustrates the coding required to generate a system 
| recovery table. The example assumes that a routine called RETURN will 
j be link-edited with the system recovery table. 


238 


CICS/VS System Programmer*s Reference Manual 





DFHSRT 

TYPE=INITIAL, 

SUFFIX=K1 

* 

DFHSRT 

TYPE=SYSTEM, 

♦ 


ABC0DE=777, 

ROOTINE=RETtJRN 

♦ 

DFHSRT 

TYPE=USER, 

♦ 


ABCODE= (888,999) , 

* 


ROUTINE=RETURN 


DFHSRT 

TYPE=USER, 

ABCODE=020 

* 

DFHSRT 

END 

TYPE=FINAL 



| Figure 3.2—15. System Recovery Table — Example 


TCT — TERMINAL CONTROL TABLE 


The terminal control table macro instruction (DFHTCT) is used to specify 
the user's CICS/VS terminal environment which can include 
telecommunication devices, sequential processing devices, graphic 
devices, and intersystem and interregion links. 

The DFHTCT macros may be generated in any order, except where 
indicated in the list of macro instructions that follows. 

| Specifications for different regions attached to the local region are 
| preceded by DFHTCT TYPE-REGION macro instructions. The individual 
macros within the terminal control table are presented in alphabetic 
order, with the exception of TYPE=INITIAL and TYPE=FINAL, in the 
following manner: 

• DFHTCT TYPE=INITIAL. 

• DFHTCT TYPE=GPENTRY — to describe a group of non—SNA terminals 
under CICS/DOS/VS. 

• DFHTCT TYPE=IRCBCH — to describe a shared data base link to batch 
regions under CICS/OS/VS. 

• DFHTCT TYPE=LDC — to generate logical device codes. 

• DFHTCT TYPE=LDCLIST — to generate lists of logical device codes. 

• DFHTCT TYPE=LINE — to describe the characteristics of a line. The 
TYPE=LINE macro must be generated before the related TYPE=TERMINAL 
macros. 

| • DFHTCT TYPE=REGION — which allows the definition of sets of 

| terminals owned by different regions or systems. 

| • DFHTCT TYPE=REMOTE — to define a terminal owned by another region. 

• DFHTCT TYPE=SDSCI — to describe data set control information. 

| • DFHTCT TYPE=SYSTEM — to identify a remote system and define the 

| connections with that system. 

| • DFHTCT TYPE^TERMINAL — to describe the individual terminals in the 

| current region and sessions with remote systems. 

| • DFHTCT TYPE=TLXID — to define the Teletypewriter (WTC only) 

I station's stored identification. 
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• DFHTCT TYPB=TLXMSG — to define the Teletypewriter (ETC only) 
disconnect messages. 

• DFHTCT TYPE=7770MSG — to define digital response messages for the 
7770. 

• DFHTCT TYPE=FINAL. 


CONFIGURATOR 


This section is intended to aid the system programmer in the preparation 
of the terminal control table (TCT) as he uses operands of the DFHTCT 
macro instruction to: 

1. Describe terminal types for VTAM and non—VTAM access methods. 

2. Describe communication lines. 

3. Specify data set control information. 

Included in this section is an indication of whether the operands of 
the DFHTCT macro instruction are: 

1. Optional or required. 

2. Applicable only to CICS/DOS/VS, CICS/OS/VS, or to both CICS/DOS/VS 
and CICS/OS/VS. 

3. Applicable or reguired only in special circumstances. 


VTAM and TCAM SWA Terminal Types (DFHTCT TYPB=TBRMINAI») 
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R Required 0 Optional 

* It is recommended that a high OPERSEC be used as a means 
to limit access to authorized users. 

1. Supported by VTAM only 

2. Required by VTAM only 

3. Required by TCAM for BMS support 

| 4. 3270 is equivalent to 3277 or L3277. TRMTYPE=3270 is the 
I recommended option for non—SNA VTAM 3270 displays. For SNA VTAM 

| 3270 displays use LUTYPE2• 

| 5. 3270P is equivalent to 3284, L3284, 3286, or L3286. TRMTYPE=3270P 

| is the recommended option for non—SNA VTAM 3270 printers. For 

| SNA VTAM 3270 printers use LUTYPE3. 
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Non—VTAM Terminal Types (DFHTCT TYPE=TERMINAL) 
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R Required 
0 Optional 
| * CICS/DOS/VS only 
♦ CICS/OS/VS only 

1. Required only for local devices* 

2. Required only for remote devices; specify hexadecimal addressing 
characters. 

3* Required; specify hexadecimal addressing characters, in the 

appropriate terminal transmission code, nonswitched lines; specify 
name of DFTRMLST for switched lines. (For TNX, not required if 
ANSWRBK=TERMXNAL is specified.) 
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4. 


Required for multipoint lines and for switched lines if 
FEATURE 2 AUTOCALL has been specified in the DFHTCT TYPB=LI1IE macro 
instruction; specify name of DFTRRLST. 

5. Required for component polling; defaults to polling all components. 

6* Required for the 2740 Hodel 2. 

7. Required for terminals when the user defines a 0—255 byte terminal 
work area (process control information field). 

8. Required for a 3275 on a leased line, not used for a dialed 3275. 

9. Optional; TRANSCEIVE is defaults 

| 10. L3270 is equivalent to L3277 for local 3270 display 

| devices. 

j L3270P is equivalent to L3284~and L3286 for 

| local 3270 printer devices. 

R3270 is equivalent to 3277 for remote 3270 display devices. 

R3270P is equivalent to 3284 for remote 3270 printer devices. 

R3275 is equivalent to 3275. 
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Data Set Control Information (DFHTCT TXPB=SDSCI) 
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E Reguired 
0 Optional 

* CICS/DOS/7S only 

# CICS/OS/VS only 

1. Not required; STSLOG is forced. 

2. Not required; CONSOLE is forced. 

3. L3270 is equivalent to L3277 for local 3270 display 
devices. 

L3270P is equivalent to L3284 for 
local 3270 printer devices. 

R3270 is equivalent to 3277 for remote 3270 display devices! 
E3270P is equivalent to 3284 for remote 3270 printer devices 
E3275 is equivalent to 3275. 
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Communication Lines (DFHTCT TYPB=LI»B1 
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B Eeguired 
0 Optional 

# CICS/OS/VS only 

* TRMMODL may be specified in TYPE=LINB or TYPB=TE8MINAL. 

0. fieguired if a terminal work area (PCI) field is to be 

defined for all terminal entries associated with this line. 

1. Specify ACCBBTH=SAM, ACCM ETH=BSAM, or ACCMETH=SEQ0E8TIAL. 

2. Maximum value of 80. 
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3. Specify ACCMETH=BTAM or ACCMETH=TCAM. 

4. Required for switched (dial-up) lines and multipoint lines. 

5. Required if FEATURE=(AUTOANSR or SCONTROL). 

6. Required for first line in switched—line pool; specify 
ANSWRBK=EXIDVBR for 3735 under ClCS/OS/VS and CICS/DOS/VS. 

7. Checking required; other features optional. 

8. Required for component polling; default: poll all components. 

9. Required for the 2740 Model 2. 

10. Specify ACCMETH=TCAM. 

| 11. L3270 is equivalent to 3277 for local 3270 display 

| devices. 

| L3270P is equivalent to L3284 and for 

| local 3270 printer devices. 

R3270 is equivalent to 3277 for remote 3270 display devices. 
R3270P is equivalent to 3284 for remote 3270 printer devices. 
R3275 is equivalent to 3275. 


CONTROL SECTION — DFHTCT TYPE=INITIAL 


The area of storage into which the terminal control table is assembled 
is established in response to the DFHTCT TYPE=INITIAL macro instruction, 
which must precede all other DFHTCT macro instructions in a terminal 
control table assembly. 

The format of the macro instruction used to establish the control 
section for the terminal control table is as follows. Note that the 
optional operands that apply only to logical units are listed separately 
in the syntax display, and are in alphabetic order in the description of 
the operands that follows. 


I 


I 


DFHTCT 


TYPE=INITIAL * 

r . ACCMBTH= ff NOMVTAM If , VTAM 1) ] 

[ ,APPLID={DBDCCICS|name)] 

[ ,ERRATT= {NO | ([ LASTLINE }[ ,INTENSIFY][ , {BLUE |RED | PINK | 
GREEN | TURQUOISE | YELLOW | NEUTRAL} ][ , {BLINK | 

REVERSE | UNDERLINE} ]) } ] 

[,SUFFIX=xx] * 

[ , SYS ID NT = (CICS | name} ] 


VTAM Only 

f.GMTBXT=( welcome—to—CICS/VS I»text *1 ] 
[,OPNDLIM=number] 

[,RAMAX=value ] 

[ ,RAMIN={0| value} } 

[ ,RAPOOL~{21value} ] 

[,RATIMES=(21value} ] 

[ ,RESP= {FME |RRN} ] 

CICS/DOS/VS Only 

[ ,M0DNAME= f IJLBTM l name} ] 


| * See the first page of this chapter. 
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ACCMETH= ([ NONVTAM][ ,VTAM ]) 

controls the building of the access-method-dependent portions 
of the TCT. If both NONVTAM and VTAM are specified, the TCT is 
built for all access methods# The default is NONVTAM. 

NONVTAM 

Virtual Telecommunications Access Method portion is not 
generated. 


VTAM 

Virtual Telecommunications Access Method portion is 
generated. 

| Mote : ACCMETH= (NONVTAM, VTAM) must be specified for TCAM SNA if 

| 1DC support is required. 




APPLID= fDBPCCICS | name} 

specifies a one— to eight—character name by which this CICS/VS 
system or region is known to other remote systems or regions, 
or to the batch region during a DL/I shared data base session 
under CICS/OS/VS. It matches the value of the NETNAMB operand 
of the DFHTCT TYPE=SYSTEM macro of the remote system or region. 


| For ISC, the name specified must match the label specified in 

the ACF/VTAM VBUILD TYPE=APPL definition. This is the globally 
known name in the network. If an ACBNAME is coded, this may be 
used as the name by which logical units in the same domain 
logon to CICS/VS, however, CICS/VS has no knowledge of this 
name. 


| The default value for APPLID is DBDCCICS. 


ERRATT= {MO | ([ LASTLINE ][ , INTENSIFY ][ , {BLUE | RED | PINK| GREEK | TURQUOISE 
| YELLOW | NEUTRAL) ][ , {BLINK |RBVERSE | UNDERLINE} ]) } 
indicates the attributes that are to be associated with error 
messages that are displayed on all 3270 screens in the terminal 
control table. The default is ERRATT=NO. 

NO 

indicates that an error message will be displayed at the 
current cursor position and without any additional 
attributes. 

LASTLINE 

indicates that an error message will be displayed starting 
at the beginning of the line nearest the bottom of the 
screen such that the message will fit on the screen. 

The other values indicate that one or more of the 3270 
attributes are to ne used when an error message is 
displayed* Specification of any attribute implies 
LASTLINE. Valid attributes are: 


for field intensification: 
INTENSIFY 

for color: 

BLUE 

RED 

PINK 


248 


CICS/VS System Programmer^ Reference Manual 




GREEN 

TURQUOISE 

YELLOW 

NEUTRAL 

for highlighting: 

BLINK 

REVERSE 

UNDERLINE 

Any attributes specified that are not valid for a 
particular device will be ignored. 


| SYSIDNT= (CICS |name} 

indicates a one— to four-character name to identify the local 
CICS/VS region. Any section commencing with a DFHTCT 
TYPE=REGION macro instruction specifying the SYSIDNT operand 
with this value will be incorporated in the local region. The 
| default value is CICS. 


V TAM Only 


GMTEXT= (welcome—to-CICS/VS |*text■} 

indicates whether the default ”good morning” sign-on message 
text (”welcome to CICS/VS”) or a user—supplied sign-on message 
text, is to be displayed at terminals signed on to CICS/VS by 
VTAM. GMMSG=YES should be specified in the DFHTCT 
TYPE=TERMINAL macro for each terminal requiring the sign—on 
message. 


OPNDLIM= QO|number} 

indicates the open destination/close destination request limit. 
This limit is used to restrict the number of concurrent OPNDSTs 
or CLSDSTs to prevent VTAM from running out of space in the 
CICS/VS region. The default value is 10. When large values 
are used for OPNDLIM, the value of GSCOR in DFHSIT (0S/VS only) 

| may need to be adjusted. Refer to Figure 8.3—3 for guidance on 

| the GSCOR value to be used for each OPNDLIM. 


RAMAX=value 

indicates the size in bytes of the I/O area allocated for each 
| RECEIVE ANY issued by CICS/VS. The maximum value is 32767. 


RAMIN={0|value} 

indicates the data length size below which RECEIVE ANY input is 
transferred from the RECEIVE ANY I/O area to a new TIOA. The 
length of the new TIOA is the greater of the data length or 
TIOAL. The maximum value is the value of RAMAX. If this 
operand is not specified the default is zero. 
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RAPOOL= (2 lvalue} 

specifies the number of fixed RPLs that are generated in the 
TCT prefix. When not at MAXTASK, CICS/VS maintains a RECEIVE 
ANY for each of these RPLs. The number of RPLs required is 
dependent on the expected activity of the system, the average 
transaction lifetime, and the MAXTASK specified. The default 
value is 2. 


RATIMES={2|value} 

specifies the multiplier used to establish the maximum 
allowable initial input message length. If the data exceeds 
the RAMAX I/O area, a new area up to a maximum size of RAMAX 
multiplied by RATIMES is allocated. If the data exceeds this 
length, a negative response is returned to the logical unit. 
This operand is optional and defaults to a value of 2. 

Note ; This operand is not used with VTAM—supported 3270s , 
because the maximum allowable input from a 3270 equals a buffer 
size, whatever the value of RATIMES. 


RESP={FME|RRN} 

specifies the type of response CICS/VS is to request when 
transmitting data to a logical unit. FME is the default and is 
the normal type of response. 

FME 

indicates that a function management end (FME) response is 
to be requested. This is equivalent to specifying a 
definite response type 1 (DR1) . 

Note : This option is not used with Vf AM—supported 3270s, 
because FME is always requested. 

RRN 

indicates that a reached recovery node (RRN) response is to 
be requested^ This is equivalent to specifying a definite 
response type 2 (DR2)• RESP=RRN may only be specified for 
3600 systems. 


CICS/DOS/VS Only 


MODNAME={IJLBTM|name} 

specifies the BTAM modules to be requested by name. The 
default is MODNAME-IJLBTM• 

IJLBTM 

indicates the system default name if MODNAME-name is not 
specified. 


name 

specifies the BTAM module name. 

Note: BTAM modules and names must be assembled and cataloged 
as described in the CICS/VS System Programmer*s Guide (DOS/VS) . 


250 


CICS/VS System Programmer's Reference Manual 



LINE GROUP TYPES — DPHTCT TYPE=GPENTRY (CICS/DOS/VS ONLY) 


Available for CICS/DOS/VS only, the DPHTCT TYPE=GPENTRY macro 
| instruction provides a restricted selection of operands that may be used 
with the following device types in a non—SNA environment: 

• Local 3270 

| • Remote 3270 on a leased line 

• multipoint 2740 

• Point-to-point 2740/2741 

• Dial-up 2740/2741 

• Processing unit console operating as a terminal 

• Sequential devices used to simulate terminals 

The DPHTCT TYPE=GPENTRY macro allows the system programmer to specify 
| terminal types and device characteristics for a group of lines, and may 
be used instead of indicating the desired features in the DPHTCT 
TYPE=SDSCI, LINE, and TERMINAL macro instructions. 

The options in each operand of this macro are positional; for 
example, LINFEAT= (0,B,,B) indicates that the first terminal in this line 
group has open polling, the second terminal has the buffered—receive 
| feature, the third terminal has only wrap-around polling (implied) , and 
I the fourth also has the buffered—receive feature. 

| Appendix B contains examples on how to specify a DPHTCT TYPE=GPENTRY 
| macro for local and remote 3270 devices. 


Local 3270 Terminals 


Local 3270 networks consist of one or more local 3270 control units. Up 
to 32 display and printer terminals may be attached to each control 
unit. 

The 3270 PRINT function works on a line group concept* A line group 
consists of one control unit with one or more 3270 displays, and may 
have one or more 3270 printers. Any display terminal can initiate a 
print request to be sent to the first available printer in the same line 
group. If there is not a printer in the group, the 3270 PRINT function 
will not operate for that group. Por example, the user may have two 
displays and one printer in one department, and one display and printer 
in another. By dividing the five terminals into two groups, the user 
can prevent the printout for one department appearing on the other*s 
printer. 

If the 3270 is the only terminal supported, it is advisable that at 
least two 3270 line groups are established, so that if one line group is 
placed out of service because of errors, terminals in the other line 
group can continue to enter data and can be used to put the first line 
group back in service. 

Each local 3270 line group is defined by a separate DPHTCT 
TYPE=GPENTRY,GPTYPE=3270L macro with the appropriate operands that apply 
to a 3270. 
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I 

I 


I 

I 

I 


I 


TYPE=GPBNTRY 

| indicates that a group of lines with their terminals is to be 

| defined. 


GPTYPE=type 

specifies the type of terminal in the line group. One type 
option may be specified in each DFHTCT TYPE=GPENTRY macro. The 
options are: 

• 3270L — Local 3270 printer or display 

• 327OR — Remote 3270 (printer or display) . The suffixes & 
(ASCII support) or B (EBCDIC support) may be appended* 

• 2740S — Multipoint 2740 with the station control feature. 
The following suffixes may be appended: 


C — for the VRC/LRC checking feature 

A — for the start/stop autopoll features This option cannot 
be used for lines attached to a 2701. 

CA — for both these features. 

• 2740 - Point—to—point 2740/2741* The options are: 


2740 - 2740 model 1 without the VRC/LRC checking feature 
2740C - 2740 model 1 with the VRC/LRC checking feature 
2741C — 2741 with correspondence code 
274 IE — 2741 with PTTC/EBCD transmission code 



TYPE=GPEMTRY 
,GPTYPB=type 

[ ,ALTSCRN= ( (lines,columns) ,...) ] 

[ ,ALTSFX= (numberf 
[ ,C0ADDR= (nn[ , :..],...) ] 

[ ,CUFEAT= (feature[ ,...],...)] 
f ,CUP0SN= (nn[ ,... ], . ..) ] 

[ ,GPBLKSZ= (nnnnn[ ,...],...) ] 

[ ,GPNAME=(IHname,00Tname) (,...,...) ] 

[ ,GPNTRMS= (nn[ ,... ],...)] 

[,GPSEQLU=(nnnf,...],...)] 
f,GPTC0={2701|2702|2703|ICA}] 

[ ,LINELST= (nnn[ ,...],...) ] 

[,LINFEAT= (featuref,...],...)] 

[ ,LINI»L= (numberf ,...],...) ) 

[,TRMADDR= (nn[,*..],...) ] 

[ ,TRMFBAT= ([ A 3[ D )[ S ][ U ][ P ][ T ][ Q ][ H ][ V ][ E ][ C )[ 
[ ,TRMIDNT= (xxxx[ ] 

[ ,TRMINL= (number[ , ...],...)] 

[,TRMMODL=(modelnumber,...,...) ] 

[ ,TRMP0SN= (nn[,..],..)] 

[ ,TRMPRTY= (numberf ,...],...) ] 
f ,TRMSTAT= ({T111A|X|R|TX(IX|AX|RX) ,...) ] 
f ,TRM0AL= {01 (numberf ,.*.],...)}] 
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• 274OD — Dial-up 2740/2741. The options are: 


2740D - 2740 Model 1 without VBC/LRC checking 
2740DC — 2740 Model 1 with VRC/LRC checking 
2741DC — 2741 with correspondence code 
274 IDE — 2741 with PTTC/EBCD transmission code 

• CONSOLE — Processing unit console 

• (Input,Output) — Sequential devices used to simulate a 
terminal. The options are: 


For tape: (TAPE,TAPE) 

For DASD: ({3330|3340|3350|FBA},£3330|3340|3350|FBA}) 

For unit record devices: 

input: 1442,2501,2520,2540,3505,3525, or 2596 

output: 1403,1404,3203,5203,1443,1445, or 3211 


ALTSCRN= ( (lines,columns) , ...) 

defines the 3270 screen size to be used for a transaction that 
| has SCRNS2E=ALTERNATE specified in DFHPCT TYPE=ENTRT.' The 

j omission of a value in the list indicates that this device does 

| not have the alternate screen size feature. The values that 

can be specified are: 


Device Alternate screen size 

3276-1,3278-1 (12,80) 

3276-2,3278-2 (24,80) 

3276-3,3278-3 (32,80) 

3276-4,3278-4 (43,80) 

3278- 5 (27,132) 

3279- 2A, 3279-2B (24,80) 

3279-3A, 3279-3B (32,80) 


| For 3287 and 3289 printers the values specified must be 

| equivalent to the size of the buffer in the particular device. 

Example: ALTSCRN= ((24,80), (32,80) ,, (12,80)) 

| which means that the first terminal has an alternate screen 

j size of 24 lines by 80 columns, the second 32 by 80 the third 

| terninal does not have the alternate screen size facility and 

| the fourth terminal has a 12 by 80 alternate screen size. 

Note that there is no validity checking performed on the screen 
size selected, and that incorrect sizes may lead to 
unpredictable results. 
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ALTSFX= (number[ ,...],.«•) 

indicates a one—character numeric suffix (specified in the 
SUFFIX operand of the application programmer*^ DFHMSD 
TYPE- {DSECT|MAP) macro)* This suffix will be appended by BBS 
to mapset names when the ALTSCRN operand is specified to allow 
different maps to be specified for different screen and page 
sizes. In this case, BBS map selection routines will attempt 
to load the mapset with the suffix specified in the ALTSFX 
operand. If this operand is not specified or if the map is not 
loaded successfully, BHS will continue with its current 
processing (that is, attempting to use a mapset with the 
appropriate device suffix and an unsuffixed mapset name.) 

Example: ALTSFX= (1, ,6) 

which means that the first and third terminals will attempt to 
use mapsets suffixed with 1 and 6, respectively. 


CUADDR= (nn[ ,.••],...) 

applies to 3270R only, and indicates the control unit address 
for each remote control unit in the line group. The range is 0 
through 31. 

| Example: CUADDR^ (0,0,1,0) 

| which means that if CUP0SH= (1,2,2,3) , the first control unit is 

| on the first line with an address of 0, the second and third 

| control units are on the second line with addresses of 0 and 1, 

| and the fourth control unit is on the third line with an 

I address of 0. 


CUF£AT= (f eature[ ,... ],...) 

applies to 3270R only, and specifies the features associated 
| with each control unit. M C H indicates the COPY feature, which 

| is currently the only feature available. The number of values 

I specified for this operand, must match the number of control 

| units. 

| Example: CUFEAT-(C, ,,C) 

I which means that the first control unit has the COPY feature? 

| the second and third have no features and the fourth control 

| unit has the COPY feature. 


CUPOSN= (nn[ , .) 

| applies to 3270R only, and indicates which line in the LIBELST 

| operand (1 through 31) each control unit is attached to. The 

| range is 1 through 40. The positions are specified in 

j ascending order. 

| Example: CUP0SN= (1,2,2,3) 

| If LINELIST= (SYS020,SYS021,5YS022), this means that there are 

| four control units; the first is on line SYS020, the second and 

j third are on line SYS021, and the fourth is on line SYS022. 
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GPBLKSZ- (nnnnn[ ,•••],•••) 

applies to sequential devices only, and specifies the block 
size of the input and output files. The range is 20 through 
32000. For unit record devices, the block size specified must 
be the same as the device buffer size* 


GPNAME= (INname,OUT name) (,...,...) 

applies only to DASD sequential devices, and specifies the 
input and output DOS/VS file names for DASD files. The name 
specified must be the same as in the DLBL job control 
statements. 


GPNTRBS=(nn[ ,*••],...) 

applies to 2740/2741 dial-up terminals only, and specifies the 
number of terminals In the line group. The range is 1 through 
40. 


GPSEQLU= (nnn[ 

applies to sequential devices (except DASD) only, and specifies 
the system logical unit number to be assigned to the input and 
output files. IPT and 1ST may be specified for unit record 
devices. 


GPTCU=(270112702|2 7031ICA} 

applies to 3270R, multipoint 2740, 2740/2741 point—to—point, 
and 2740/2741 dial-up terminals, and specifies the transmission 
control unit attached to the processor. The options are: 2701, 
2702, 2703, and ICA. 270x must be specified when the 27Ox 
control unit is being emulated by a 370x. 2701 may not be 

specified for 2741 point-to-point and dial-up terminals. 


LINELST=(nnn[ 

is available for all group types except sequential and console 
devices, and specifies the system logical unit number (nnn or 
| SYSnnn) assigned to each line in the group* A maximum of 31 

lines may be defined in this list. 

| Example: LINELST= (020,021,022) or (SYS020,SYS021 ,SIS022) 


| LINFEAT= (f eature[ 

| applies to 3270R and multipoint 2740 terminals only, and 

| specifies the line features. Wrap-around polling is implied; O 

I indicates open polling, and B (2740 only) indicates the 

| buffered receive feature. 

| Example: LIWFEAT= (,0,) 

| means that the first and third lines have no features, and 

| the second line has open polling. 
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LININL= (number[ ,...],..•) 

applies to local 3270s, all 2740/2741 terminals, and sequential 
devices, and specifies the terminal input area length. The 
number specified should be large enough to handle 8OX of the 
input messages. 

For 2740 model 2 multipoint devices, the maximum length is the 
buffer size minus 2. CICS/VS truncates messages longer than 
this length. 

For sequential devices, the value in LXNINL must be greater 
than that in GPBLKSZ if the application program will reuse the 
same message area for output. 

| Example: LININL= (50,0,100) 


TRHADDH S (nn[ , . .. J, . • . ) 

applies to 3270R and 2740 multipoint terminals, and specifies 
the address of each terminal in the line group. The range is 0 
through 31 for 3270R, and A—Z, 0—9, and & for 2740s. 

| Example: TRMADDR= (0,1,2,0,0) 

| means that, if TRMP0S»= (1,1,1,2,3), the first three 

I terminals are on the first control unit with addresses 0, 

| 1, and 2, the fourth terminal is on the second control unit 

| with address 0, and the fifth terminal is on the third 

| control unit with address 0* 


| TRMFE AT= ([ A ][ D I S ][ U ][ P ][ T ][ Q ][ H ][ V ][ E X C ][ , . . . ]) 

applies to local and remote 3270s, 2740/2741 point—to—point, 
and 2741 dial-up terminals, and indicates the features for each 
terminal in the line group. 3270 displays may have a 
combination of A, D, S, 0, Q, H, V , E, and C. The options are: 


I 

I 

I 


•A — audible alarm feature 

• D — dual case keyboard 

• S — selector pen feature 

• U — upper case translate (should not be specified 

for terminals which support extensions to the 
3270 data stream). 

• P — printer (required for 3270 printers)* CUFEAT 

must be specified with C, and the 3270 control unit must 
have the COPY feature. 

• T — 2740/2741 text mode (lowercase letters are to be 

preserved in input messages)• 

• Q — programmed symbols (PS) 

• H — highlighting 

• V — validation 

• B — supports extensions to the 3270 data stream 

• C — color 
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I Note : Support for extensions to the 3270 data stream is 

I implied by specifying H, V, Q, or C, and a value of E need not 

j be explicitly stated. 

| Example: TRMFEAT= (ADSU,,P,A,H,EC) 

| which means that the first terminal has the audible alarm, the 

dual case keyboard, the selector pen, and the upper case 
translate features, the second terminal has no features, the 
third has a printer, the fourth has the audible alarm feature, 
| the fifth has the highlighting feature, and the sixth supports 

| extensions to the 3270 data stream and has the color feature. 


TRMIDNT=(xxxx[ 

specifies a four—character terminal identification for each 
terminal in the line group. CNSL must be specified for 
processing unit console support. 


| Examples: TRMIDNT= (R77A,R77B,R86 A,R75B) 

| TRMIDNT=CNSL 


TRMINL= (number[ 

applies to 3270R only, and specifies a terminal input area 
length that is large enough to handle 80% of input messages. 
If the number specified is too small, CICS/VS issues GETMAIN 
macros to obtain additional storage. Too large a number will 
| increase the VSE working set and will degrade the system. 

TRMINL=0 must be specified for printer input areas. 


Example: TRMINL= (50,50,0,50,50) 


| TRMM0DL= (modelnumber[ 

applies to 3270L, 3270R, and multipoint 2740 terminals, and 
indicates the model number of each terminal in the line group. 
The options are: 


Device 

Buffer size 

Model number 

3277 

480 

1A 


1920 

2A 

3284 

480 

IB 


1920 

2B 

3286 

480 

1C 


1920 

2C 

3275R 

480 

ID 


1920 

2D 

3275 + printer 

480 

IE 


1920 

2E 

2740 model 1 


1 

2740 model 2 

120 

1A 


248 

2B 


440 

2C 


| For devices with the alternate screen size facility the 

| following model numbers should be used to define the default 

| screen size: 
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I 


Davies 


Buffer size 


Model number 


I 

I 

I 

I 


Display 

480 

1A 


1920 

2A 

Printer 

480 

IB 


1920 

2B 


| Example: 


TRMMODL=(1A,2A,2C,IB,2B) 


TRMPOSN®(nn[,..],..) 

applies to 3270R and 2740 multipoint devices, and indicates the 
relative position of the control unit (C0POSN=1 through 40 for 
3270R) or of the line (LINELST=1 through 31 for 2740) to which 
each terminal is attached. In both cases, a maximum of 40 
terminals may be defined. 


Example: TRHP0SH=(1,1,1,2,3) 

If CUP0SN= (1,2,2,3) and LINELST= (020,021,022), this means that; 
SYS020 has one 3271 with 3 terminals; SYS021 has two 3271s, 
each with one terminal. 


TRMPRTI-(number[ ) 

is valid for all device types except sequential devices, and 
indicates the priority assigned to each terminal in the line 
group. The task processing priority is equal to the sum of the 
terminal, operator, and transaction priorities. The sum must 
not exceed 255. 

| Example: TRMPRTY=(50,50,100) 


| TRHSTAT—((T111 A|X|fi|TX| IX|AX|RX} ,...) 

I applies to 3270 remote, 2740 multipoint, 2740/2741 point-to- 

point, 2741 dial-up, and sequential devices, and indicates the 
status of each terminal in the line group. The options are: 


• T — transaction status 
•I — input status 

•A — transceive status 

• X — out of service 

• R — terminal is being used as a printer and may not be used 

to enter data 


\ Example: TRMSTAT=(T,A ,&X) 

| Full details of these options can be found under the TRMSTAT 

| operand in DFHTCT TYPE=TEBMIHAL. 
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TRMUAL={0| (numberf 

is available for all device types and indicates, for each 
terminal in the line group, the size of the terminal control 
table user area if this area is used by application programs. 
Any information stored in this area is available to all 
transactions originated by this terminal. The maximum TRMUAL 
size is 255 bytes; the default is 0. 


| Example: TRMUAL= (50,50,0,50,50) 


COMMUNICATE WITH BATCH REGIONS — DFHTCT TYPE=IRCBCH 
(CICS/OS/VS ONLY) 


The DFHTCT TYPE^IRCBCH macro instruction defines the link between the 
CICS/OS/VS system and the batch systems that share DL/I data bases with 
CICS/VS. 



IDFHTCT | TYPE=IRCBCH 
| | ,SESNUMB=number 


I 

I 


TYPE=IRCBCH 

indicates that a DL/I shared data base session is to be 
initiated under CICS/OS/VS. 


SESNUMB=number 

indicates the maximum number of batch regions that can 
concurrently share DL/I data bases when in session with 
CICS/OS/VS. Note that the number of DL/I threads (specified in 
the DLTHRED operand of DFHSIT) may need to be increased to 
accommodate the value specified in SESNUMB. 


| INTERCOMMUNICATION LINKS - DFHTCT TYPE=ISLINK 

I 

| This has now been replaced by DFHTCT TYPE=SYSTEM described below. The 
| keyword I SLINK may still be used for compatibility with earlier 
| releases. 


SYSTEM LDC TABLE AND EXTENDED LOCAL LDC LIST — DFHTCT 
TYPE=LDC 


The DFHTCT TYPE=LDC macro instruction generates the system LDC table and 
allows the system programmer to: 

• Request a set of default logical device codes (LDCs) and parameters 
for 3600, 3770 batch, LUTYPE4, or 3770/3790 batch data interchange 
logical units. 

• Establish the page size and page status for logical units 
associated with a terminal. 

• Specify an LDC for a BMS operation. 
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• Override the system LDC table by an extended local LDC list, 

generated by the LOCAL=INITIAL and FINAL operand, which enables LDC 
mnemonics to be used in an application program to refer to 
different device types. 

Logical device codes are used to identify a device that is attached 
to a logical unit. The device does not communicate directly with 
CICS/VS, but through the logical unit. For example, a card punch device 
may be attached to a 3770 logical unit: the CICS/VS application program 
can direct punch output, through BMS, via the 3770 to the card punch 
device• 

For further information on LDCs, refer to the appropriate CICS/VS 
subsystem guide. 

When an output operation is requested using a particular LDC, 
resolution of the mnemonic is attempted from the list referenced by the 
LDC operand of the DFHTCT TYPE=TERMINAL macro. This list can be a local 
list specified in the LDC operand of the DFHTCT TYPE=TERHINAL macro, or 
specified by the DFHTCT TYPE=LDCLIST macro, which is pointed to by the 
LDC operand. 

Alternatively, it can be an extended local LDC list, generated by a 
set of DFHTCT TYPE=LDC macros. The extended local LDC list allows the 
system LDC table device characteristics to be overridden. If the LDC is 
not located in the local list or in the extended local list, the LDC 
specified is not valid for that terminal entry. In this case, X*00 # is 
inserted in the logical device code portion of the FMH, and no 
destination name is inserted. 

When a BMS function is requested for an LDC, resolution of the 
mnemonic is attempted as above. If successful, the device 
characteristics (for example, device name and destination name) are 
accessed. If the local list is extended, these characteristics lie 
within the located local list entry. If it is not extended, the system 
LDC table is searched for the LDC and the associated device 
characteristics. 

| The expansion of this macro is the same, regardless of where it is 
| specified in the TCT definition. 


i-»-1---1 

|[name]|DFHTCT | TYPE=LDC | 

| | | [,DSN=destination—name] I 

| | | [,DVC= (device-type,sub-address)] | 

| | | [,LDC={SYSTEH|LUTYPE4|3600|BCHLU|(aa[=nnn])}] | 

|| | | [,LOCAL = {INITIAL|FINAL} ] | 

| | | [ ,PGESIZE= (row,column) ] j 

| | | [ ,PGESTAT={AUTOPAGE|PAGE} ] | 

i_._—-1 


name 

indicates the name of the extended local LDC list and should be 
the same as that specified in the LDC operand of the DFHTCT 
TYPE=TERMINAL macro, and Is only required if LOCAL-INITIAL is 
specified. 


TYPE=LDC 

indicates that an LDC is being defined to the system LDC table 
or to the extended local LDC list. 
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DSN=destination—name 

specifies the name to be used by BBS for destination selection 
for the batch data interchange logical unit. Refer to the 
relevant CICS/VS subsystem guides for further information on 
destination selection. 


DVC= (device—type,sub—address) 

specifies the device type associated with the LDC to be used 
for a BBS request. This operand can only be specified in 
| conjunction with the LDC=aa[=nnn] operand. 

| device—type 

| may be specified as follows: 


Device Type 

Explanation 

3604 

Keyboard display 

3610 

Cut—forms document printer or journal 
printer (including the document/journal 
printer of a 3612) 

3612 

Passbook portion of a 3612 

3618 

Currently selected carriage 

3618P 

Primary carriage 

3618S 

Secondary carriage 

3618B 

Both carriages 

BLUCON 

Batch logical unit console printer 

BLUPRT 

Printer component of a batch logical unit 

BLURDR 

Card input component of a batch logical unit 

BLUPCB 

Card output component of a batch logical unit 

WPMED1 

Word processing media 1 

WPMED2 

Word processing media 2 

WPMED3 

Word processing media 3 

WPMED4 

Word processing media 4 

Notes: 



1. The device types BLUPRT, BLURDR, BLUPCH and BLOCON are 
devices attached to a batch, batch data interchange, or 
L0TYPB4 logical unit. 

2. The WPMED1, 2, 3, and 4 options apply to LUTYPE4 logical 
units only^ The component to which these options apply is 
defined by the particular type 4 logical unit 
implementation. 

sub—address 

specifies the media sub-address. The range is 0 through 
15, with a default of 0. A value of 15 indicates any sub- 
address. The sub—address differentiates between two units 
of the same device type (for example, BLUPRT,0 and 
BLUPRT,1), which could be two print components attached to 
one logical unit. 


| LDC~ ( SYST EM ILUTYPE4 136001BCHLUI (aa[=nn})} 

specifies the LDC mnemonic and numeric value to be defined. 

The default is LDC=SYSTEM. Only the LDC=aa[=nnn] option can be 
used in conjunction with the DVC, PGESIZE, and PGESTAT 
operands. 
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SYSTEM 

indicates that the following system—default LDCs for 3600, 
batch, and LUTYPE4 logical units are to be established: 


LDC LDC Device Pagesize 

Mnemonic Value (row,column) 


DS 

1 

3604 Keyboard Display 

6,40 

JP 

2 

3610 Document Printer 

1,80 

PB 

3 

Passbook and Document 




Printer 

1,40 

LP 

4 

3618 Administrative 




Line Printer 

50,80 

MS 

5 

3604 Magnetic Stripe 




Encoder 

1,40 

CO 

0 

Console medium or default 




print data set group 


HI 

32 

Card input medium 

1,80 

Hi 

32 

Card output medium 

1,80 

PI 

48 

Print medium or print 

50,80 



data set group 


W1 

128 

Word processing media 1 

50,80 

W2 

144 

Word processing media 2 

50,80 

W3 

160 

Word processing media 3 

50,80 

W4 

192 

Word processing media 4 

50,80 


LUTYPE4 

indicates that system—default LDC mnemonics are to be 
established for an LUTYPE4 (word processing) logical unit. 
These consist of the CO, R1, PI, HI, Wl, W2, W3, and W4 
mnemonics, the corresponding LDC values, and the 
appropriate page sizes. 


3600 

indicates that system—default LDC mnemonics for the 3600 
are to be established. These consist of the DS, JP, PB, 

LP, and MS mnemonics, the corresponding LDC values, and the 
appropriate page—size and page-status. 

BCHLU 

indicates that system-default LDC mnemonics for a batch 
logical unit are to be established. These consist of the 
CO, SI, PI, and HI mnemonics, the corresponding LDC values, 
and the appropriate page—size and page—status. 


indicates the two—character mnemonic to be used for this 
LDC. 

nnn 

indicates the numeric value to be associated with the 
LDC in the system or extended local LDC list. The 
value in the system list is used as a default value for 
this LDC if a value is not found in a local LDC list 
(which is not extended) associated with a TCTTE. A 
value must be specified for 3600 devices* k value need 
not be specified for batch, batch data interchange, or 
LUTYPE4 logical units, but if one is specified it must 
correspond to the LDC value for the device type. 
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| LOCAL= {INITIAL|PINAL} 

indicates that an extended local LDC list is to be generated. 
INITIAL 

indicates that this is the start of an extended local LDC 
list. 

PINAL 

indicates that this is the end of an extended local LDC 
list. 

Note s LOCAL=INITIAL or FINAL may not be specified in the same 
DFHTCT TYPE=LDC macro as other operands. All DFHTCT TYPE=LDC 
entries specified after LOCAL=INITIAL and before LOCAL=FINAL 
will form part of one extended local LDC list; the entries 
specified outside the structure of this group will be added to 
the system LDC table. See the extended local LDC list example 
below. 

The following is an example of an extended local LDC list. 


I 


I 


LDC A 


DFHTCT TYPE=TEBMINAL,TRHIDNT=BTCH,TRf!TYPE=BCHLU, 
ACCMETH=VTAM,LDC=LDCA 
DFHTCT TYPE=LDC,LOCAL=INITIAL 

DFHTCT TYPE=LDC,DVC=BLUPRT,LDC=AA,PGESIZE=(6,30) 
DFHTCT TYPE=LDC,DVC=BLUPCH,LDC=BB,PGESIZE= (1,80) 
DFHTCT TYP£=LDC,DYC=3LUC0N,LDC=CC,PGESIZE=(1,132) , 
PGESTAT=AUTOPAGE 
DFHTCT TYPE=LDC,LOCAL=FINAL 


* 


* 


PGESIZE=(row,column) 

specifies the logical page size to be used with this LDC when 
BMS requests are processed. 


PGESTAT=f AUTOPAGE I PAGE} 

specifies the type of paging activity that may occur for this 
LDC. The default is AUTOPAGE. 

AUTOPAGE 

indicates that all requests to output data from the page 
supervisor are to be automatically paged, unless specified 
otherwise in the DFHBftS macro instruction. When 
autopaging, the page supervisor writes all pages in a page 
series automatically* Requests to write data directly to 
the logical unit are not controlled by the PAGE or AUTOPAGE 
parameter because the page supervisor is not used for 
direct output. 

If the default PGESIZE and/or PGESTAT values provided by 
the LDC operand are to be overridden, a specific LDC should 
be coded with the mnemonic to be overridden. This 
overriding LDC must be coded in the LDC table prior to the 
LDC operand being specified. 

Note: PGESTAT=AUTOPAGE may be used to override the PGESTAT 

specification in DFHTCT TYPE=TERMINAL. 
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PAGE 

indicates that all requests to output data from the page 
supervisor are to he paged, unless specified otherwise in 
the DFHBMS macro instruction. When paging, the first page 
from the paging supervisor is written when the logical unit 
becomes available. All subsequent pages in a page series 
are written on request of the logical unit (through the 
operator if so designed) through the use of paging 
commands. 


LOCAL LDC LIST - DFHTCT TYPE=LDCLIST 


The DFHTCT TYPE=LDCLIST macro instruction, which may be used with 3600, 
LUTYPE4, and batch logical units, allows the user to build a common list 
of logical device codes (LDCs) to be shared by more than one TCTTE• 

The system programmer is responsible for setting up the LDC structure 
to be used with the terminal. 

To define a list of LDCs to be used by several TCTTEs, the following 
macro instruction must be generated: 

| The expansion of this macro is the same, regardless of where it is 
| specified in the TCT definition. 


i-r 

Jlistnamel 

I I 

I_L 


DFHTCT 


| TYPB=LDCLIST 

| ,LDC= (aa[=nnn][ ,bb[ =nnn ] ][ ,cc[ =nnn33#* • 



listname 

is the required name of the LDC list. This name is referenced 
by TCTTEs through the LDC operand in DFHTCT TYPE=TEBflINAL. 


TYPE=LDCLIST 

indicates that an LDC list is being defined. 


LDC= (aa[=nnn3[ ,bb[ =ann 3 3[ ,cc[ =nnn3], . *.) 

specifies the LDCs (mnemonics and, optionally, the LDC numeric 
value) in this list. 

(aa[=nnn 3[ ,bb[ =nnn] j[ ,cc[=nnn 33# • • • 3) 
generates the LDCs in the list. 


aa,bb,cc... 

are the two—character mnemonics of the LDCs in this 
list. 


nnn 

is a decimal value in the range 1 to 255 to be 
associated with an LDC. If a value is not specified, 
the system default value from the table defined by the 
DFHTCT TYPE=LDC macro instruction, is used for this 
LDC. This value need not be coded for a batch or 
LUTYPE4 logical unit, but if it is, it must correspond 
to the LDC value for the device. LDCs for devices 
attached to a batch or LUTYPE4 logical unit are listed 
under the LDC parameter of the DFHTCT TYPE=LDC macro. 
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COHHUNICATION LINES - DFHTCT TYPE=LINE 


For sequential, TCAM, and BTAM terminals, communication paths to the 
terminals on the system can be described by the DFHTCT TYPE=LINE macro 
| instruction. The expansion of this macro instruction for local regions 
is the terminal control table line entry (TCTLE) and contains the data 
event control block (DECB) which is used to communicate with the 
| appropriate access method. For remote regions, no TCTLE is generated. 
The terminals related to this line must be described immediately 
following this macro instruction in DFHTCT TYPE=TERHINAL macro 
instructions. However, when describing a switched—line network, all the 
lines for a given pool should be described before the terminals for that 
line pool are described. 

One or more DFHTCT TYPE=LINE macro instructions must be generated for 
each line group. The DSCNAMB=name operand of each of the DFHTCT 
TYPE=LINE macro instructions must contain the same name as was specified 
in the DSCNAME=name operand of the related DFHTCT TYPE=SDSCI macro 
instruction. 

A DFHTCT TYPE=LINB macro instruction must be generated for each 
logical pair of sequential SDSCI macro instructions. For CICS/DOS/VS 
console terminal support, a DFHTCT TYPE=LINE macro instruction must be 
generated following the DFHTCT TYPE=SDSCI,DEVICE=CONSOLE macro 
instruction. 

A DFHTCT TYPE=LINE macro instruction must be generated for each 
symbolic unit (relative line) specified in the LINELST=parameter operand 
of the BTAM SDSCI macro instruction. The DFHTCT TYPE=LINE macro 
instruction entries must be contiguous on switched—line pools. For the 
local 3270 Information Display System under CICS/DOS/VS or CICS/OS/VS, 
only one DFHTCT TYPE=LINE macro instruction is generated for each line 
group. 

For Teletypewriters (WTC only), one DFHTCT TYPE=LINE and one DFHTCT 
TYPE=TERMINAL macro instruction must be specified for each line 
attachment in the system* 

A DFHTCT TYPE=LINE macro must be generated for each TCAfl TYPE=SDSCI 
macro. 
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r . 

1- 

r 

• 


IDFHTCT 

| TYPE=LINE 



i 

| ,ACCMBTH=method 



i 

| ,INAREAL=length 



i 

| ,TRMTYPE=type 



i 

| [,ANS»RBK={AUTOMATIC!TERMINAL|NOLL|BXIDVBR}] 



i 

1 f .BSCODE=fEBCDIC 1 ASCII! } 



i 

| [,BTAMRLN=nu«ber] 




| [ ,CLASS= ([CONVi BATCH ][, VIDEO | HARDCOPY | AUDIO] 



i 

| [,BISYNC]) ] 



i 

| [,CONVTAB={EBCDIC|ASCIIITBXTMODEIABB|ABC}] 



i 

| [,DSCNAME=name] 



i 

| [ , ERRATT= {NO | ([ LASTLINE ][ ,INTENSIFY ][ , {BLUB |RED 



i 

| |PINK|GREEN|TURQUOISE|YELLOW|NEUTRAL} ][, {BLINK 



i 

| | REVERSE IONDBSLINE} ])} ] 



i 

| [,ERRMSG=symbolic—address] 



i 

j [ r PEATURE= (feature[ ,feature] r ...) ] 



i 

| [,FSTTBRM=name] 



i 

| [,GBNPOLL=YES] 



i 

| [,ISADSCN=naae] 



i 

| [ ,LINSTAT=*OUT OF SERVICE'] 



i 

| [ ,LISTADR= (name[ ,WRAP ]) ] 



i 

| [ , NP DEL AY =number ] 



i 

| f ,OSADSCN=uame] 



i 

| [,POOLADR=symbolic—address] 



i 

| [,RDYMSG=symbolic—address] 



i 

| [,TCTUAL={0|length}] 



i 

1 

| [,TRMMODL=model(character] 

1 



1 

i 

1 

1 CICS/OS/VS Only 

i 



1 

i 

1 

| [,OUTQ=symbolic—name] 



i 

| [,POOL=YES] 



i 

| [,POOLCNT=number] 



i 

1 [,QUEUEID=hexadecimal—number] 




| [,TCAMFET=SNA] 


L 

i_ 

i--—---—---- 

_1 


Note : Questions regarding terminal control table parameter selections 
may be clarified by referring to the TCT Configurator at the beginning 
of this section* 


TYPB=LINE 

specifies a communication line* 


ACCMETH=method 

specifies the access method to be used. Grouped according to 
synonymity of function, the applicable keyword parameters are: 

SAM, BSAM (Sequential devices) 

BTAM 

BGAB (CICS/OS/VS Only) 

TCAM (CICS/OS/VS Only) 

When TRMTYPE=CONSOLB is specified (CICS/DOS/VS only), SAM is 
defaulted. 
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INAREAL=length 

specifies the message input area length* This value, as a 
minimum, must be specified as follows: 

• For start/stop devices, the length should be equal to the 
length of the longest initial sentence of a transaction. 

• For start/stop devices with the buffer receive feature (for 
example, the 2740 Communication Terminal Model 2), the 
length should be equal to the length of the buffer less two 
bytes. 

• For binary synchronous devices, the length may be 
calculated as (a+ 1 ) (b+ 2 ) + 1, where »*a" is the number of 
blocks sent by a device in response to an R¥I (reverse 
interrupt) from CICS/VS, and "b" is the size, in bytes, of 
each block. 

• For the remote 3270, the length specified should not be 
less than 254 or not less than 255 if the automatic polling 
facility (FEATURE=AUTOPOLL) is used. At no time can a 
message whose length exceeds the INAREAL value by more than 
2000 bytes be read* 

• For the local 3270, the value specified may be any number 
greater than zero. This value indicates the minimum size 
of the Terminal Input/Output Area (TIOA) that will be 
passed to the transaction by the terminal control program. 

• For performance considerations and to minimize screen 
•■blinking", the value specified should be equal to or 
greater than the length of the expected input message; at 
no time can a message be read whose length exceeds the 
INAREAL value by more than 4000 bytes (unless the 
transaction provides a TIOA for the read large enough to 
contain the message). 

• For sequential (BSAM) devices, the length should be equal 
to the length of the longest initial logical record of a 
transaction which may include multiple physical records. 
(See "BODI" under DFHSG PROGRAM=TCP.) 

• For CONSOLE devices, the maximum length (and default) is 
80. Shorter input area lengths may be specified if 
desired. 

• For TCAM: 

— for an input line entry, the INAREAL value must be 
equal to or greater than the corresponding TCAM PCB 
buffer size* 

— for an output line entry, the INAREAL value must be 
equal to or less than the corresponding TCAM PCB buffer 
size. 

Note: The minimum TIOA passed to a transaction which is 

running under control of 2260 compatibility is governed by the 
CMPT60L operand in the DFHSG PROGRAM=TCP macro instruction. 
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TRMTYPE=type 

specifies the terminal type associated with this communication 
line. One of the following may be specified: 

1050, 1053, 2260, L2260, 2265, 2740, 2741C, 2741E, 2770, 

| 2780, 2980/ R3270, R3275, 3275, 3277, L3270, L3277, L3270P, 

| R3270P, 3284, L3284, 3286, L3286, 3600, 3660 3735, 3740, 

3780, 7770, SYS/3, SYS/7, S370, S/7BSCA* CRLP, DASD, TAPE, 
TLX, TWX, U/R, TCAM (CICS/OS/VS only), or CONSOLE 
(CICS/DOS/VS only) . 

Notes : 

| 1. TRMTYPE=L3270P or R3270P also generates support for the 

| 3288 printer. 

| 2. L3270 or R3270 should be specified for 3276 or 3278 

| displays. 

| 3. L3270P or R3270P should be specified for 3287 or 3289 

| printers. 

Only one TRMTYPE operand can be included in each DFHTCT 
TYPE=LINE macro instruction. This operand, when specified, 
establishes the default specification that will be used when 
the TRMTYPE operand is not specified in a DFHTCT TYPE=TBRMINAL 
macro instruction associated with this line. If no TRMTYPE 
operand is specified in the DFHTCT TYPE=LXNE macro instruction, 
a TRMTYPE operand must be supplied in each DFHTCT TYPE=TERMINAL 
macro instruction for that line. 

The use of the TRMTYPE operand in the DFHTCT TYPE=LINE macro 
instruction is optional unless one of the following conditions 
exists: 

• A 7770 is associated with the line. 

• A local 3270 is associated with the line. 

• One or more remote 3270s or 3740s are associated with the 
line. 

• A 3600 BSC device is associated with the line. 

In each of these cases an appropriate device—type parameter 
must be specified in the TRMTYPE operand as follows: 

• TRMTYPE=7770 for the 7770. 

| • TRMTYPE=L3270, or TRMTYPE=L327OP for a local 3270. 

| • TRMTYPB=R3270, TRMTYPE=R3270P, or TRMTYPE=R3275, for a 

| remote 3270. 

• TRMTYPE=3740 for a remote 3740. 

• TRMTYPE=3600 for a 3600 Finance Communication System using 
BTAM. If a remote 3270 and a 3600 BSC device are both 
associated with one line, the remote 3270 must be 
specified. 

TWX is the CPT—TWX (Model 33/35), DASD is a direct access 
storage device, CRLP is a card reader and line printer (a pair 
of sequential devices simulating a terminal), TAPE is a 
magnetic tape device, U/R is a general term that refers to any 
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reader, or printer, and S/7BSCA is the System/7 with the Binary 
Synchronous Communications Adapter• 

CONSOLE is the processor printerAeyboard or display operator 
console and is valid for CICS/DOS/VS only. 

TCAM is used to specify a TCAM—only terminal associated with 
this communication line. This allows terminals supported by 
TCAM to use the TCAM interface through CICS/0S/7S. Device 
dependent editing must be handled by the user*s message control 
program if a TCAM terminal type is specified. CICS/VS systems 
programs only insert NL characters. 

When using TCAM, the following parameters are required: 
ACCMETH=TCAM, DSCNAME, and INAREAL. QUEUE ID, NPDELAY, 
TCAMFBT=SNA, and OUTQ are optional* TCAM is valid for 
CICS/OS/VS only* 

If either 3270 data stream or 2260 support is required under 
TCAM, the appropriate 3270 terminal type (for example, L3270, 
L3270P) or the appropriate 2260 terminal type (for example, 
L2260) must be specified in the TRMTYPE operand. This will 
enable BMS to generate the correct data stream. TRMTYPE=TCAM 
should be used for all other terminals which require EBCDIC 
support* BMS will supply new line editing for those terminals 
specified in this way. 

For details of TCAM SNA device support, refer to the 
TCAMFET=SNA operand later in this macro. 


ANSWRBK={AUTOMATIC|TERMINAL|NULLIEXIDVER} 

must be indicated for switched lines to specify the terminal 
identification to be used. If this operand is used, 

FEATURE=AUT0ANSR must also be specified. Only one of the 
following keyword parameters may be specified: 

AUTOMATIC 

indicates automatic terminal identification. This 
parameter may be coded only for the Common Carrier 
Teletypewriter Exchange Terminal Station (Model 33/35) and 
for the Teletypewriter (WTC only). 

TERMINAL 

indicates that tne terminal will be identified by the 
operator. This parameter may be coded for the TWX, 1050, 
2740, 2741, and dial-up binary synchronous devices. (After 
the dial-up connection has been made, the operator must 
enter the terminal identification as it appears in the 
terminal control table.) If 3275s or 3735s share the line, 
EXIDVER must be specified. 


NULL 

indicates that the terminal will not be identified by 
either the terminal or the operator. This parameter may 
only be specified for the 7770. (After the dial-up 
connection has been made, the terminal control program 
connects this line to the next available terminal in the 
terminal pool.) 
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EXIDVER 

indicates that the terminals unique ID sequence will be 
identified by BTAa-expanded ID verification. This 
parameter must be coded for any line on which there is a 
3275 or 3735. If devices which do not transmit unique ID 
sequences share the line with 3275s or 3735s, the operator 
must enter the terminal identification for these devices 
after the dial-up connection has been made. 

Note s These keyword parameters are valid only if the 
corresponding keyword parameters have been included in the 
DPHSG PROGRAM=TCP,ANSWRBK=(identification) operand. 


B SCO DE = {EBCDIC | A SC 11} 

specifies the type of communication code to be used for a 
binary synchronous communication device on the line. The 
default is BSCODE=EBCDIC. 

EBCDIC 

indicates transmission in Extended Binary Coded Decimal 
Interchange Code. 

ASCII 

indicates transmission in American Standard Code for 
Information Interchange. 


BTAMRLN=number 

specifies the relative line number within a line group. The 
relative line number can ne specified in the range from 1 
through 32 for CICS/DOS/VS and from 1 through 256 for 
CICS/OS/VS. This operand is not applicable to BSAM, BGAM, or 
local 2260s, and local 3270s for CICS/DOS/VS. 


CLASS= ([CONV | BATCH ][ ,VIDEOjHARDCOPY|AUDIO ][ ,BISYNC]) 

indicates the device classification associated with this 
communication line. The options for the CLASS operand are for 
purposes of documentation and clarity only. However, if the 
CLASS operand is used, CLASS=BISYNC must be specified for 
terminals on BSC lines, because this value will be inspected by 
DFHTCP. CLASS can be omitted, in which case BISYNC will be 
assumed for BSC lines. 

The CLASS specified for the line becomes the default CLASS 
specification for terminals on that line. This operand does 
not apply when CONSOLE is specified as device. The applicable 
keyword parameters are: 

CONV 

Device with conversational type application 
BATCH 

Data collection type device 
VIDEO 

Display device. Also, all units of the 3270, including 
3270 printers 
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HARDCOPY 

Hard-copy start—stop device (that is, the TWX, 1050, 2740, 
and 2741 terminals) 

AUDIO 

Audio response device 
BISYNC 

Binary synchronous device 

Multiple parameters may be specified, taking into account that 
the following groups are mutually exclusive: CONV and BATCH; 
VIDEO, HARDCOPY, and AUDIO. 


CONVTAB={EBCDIC|ASCII|TEXTMODE|ABB|ABC} 

specifies the type of transmission code, and may be used 
instead of the BSCODE operand for binary synchronous devices. 
The applicable keyword parameters are: 

EBCDIC 

Extended Binary Coded Decimal Interchange Code 
ASCII 

American Standard Code for Information Interchange 
TEXTMODE 

Text mode for the 2741 Communication Terminal 


ABB 

ABB code for the 7770 Audio Response Unit Model 3 

ABC 

ABC code for the 7770 Audio Response Unit Modal 3 


DSCNAME=name 

specifies the data set control name for this communication 
line. It is not applicable for BSAM. The DSCNAME for BTAM and 
TCAM data sets must be the same name as that specified in the 
DSCNAME operand of the related DPHTCT TYPE=SDSCI macro 
instruction. 


ERRATT= {NO | ([ LASTLINE ][ , INTENSIFY }[ , {BLUE | RED | PINK | GREEN | TURQUOISE | YELLOW | 
NEUTRAL} ][ (BLINK) REVERSE |UNDERLINE} ]> } 

indicates the attributes that are to be associated with error 
messages that are displayed on all 3270 screens on this line. 

This will override the value of ERRATT specified on the DFHTCT 
TYPE=INITIAL macro instruction. The default is ERRATT=NO. 

NO 

indicates that an error message will be displayed at the 
current cursor position and without any additional 
attributes* 

LASTLINE 

indicates that an error message will be displayed starting 
at the beginning of the line nearest the bottom of the 
screen such tnat the message will fit on the screen. 
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The other values indicate that one or more of the 3270 
attributes are to be used when an error messages is 
displayed. Specification of any attribute implies 
LASTLINE. Valid attributes are: 


for field intensification: 

INTENSIFY 

for color: 

BLUE 

RED 

PINK 

GREEN 

TURQUOISE 

YELLOW 

NEUTRAL 

for highlighting: 

BLINK 

REVERSE 

UNDERLINE 

Any attributes specified that are not valid for a particular 
device will be ignored. 


ERRMSG=symbolie—address 

specifies the symbolic address of the error message used by 
CICS/VS to communicate with terminals attached to the 7770 
Audio Response Unit. The error message is required when 
TERMTYPE=7770 is specified and is defined through the DFHTCT 
TYPE=7770MSG macro instruction (see the '•Digital Response 
Messages for the 7770 Audio Response Unit 11 macro later in this 
section.) 


FEATURE=(feature[,feature],...) 

indicates that one or more optional features are present on a 
given line. These features can be specified in any order using 
the following keyword parameters: 


AUTOANSR 

the automatic answering feature for switched lines. For 
terminals on switched—line networks, FBATURE=AUTOANSR must 
always be specified. 


AUTOCALL 

the automatic calling feature for switched lines. 


AUTOPOLL 

the automatic polling feature required for multipoint 
binary synchronous communication terminals and optional for 
the 1050 Communication System and 2740 Communication 
Terminal; If AUTOPOLL is specified for the 2740, SCONTROL 
must also be specified* FEATORE=AUTOPOLL must be specified 
if AUTOLST or AUTOWLST is specified in the BTAM DFTRMLST 
macro. 
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BUFFRECV 

the buffer receive feature for the 2740 Communication 
Terminal Model 2. If BUFFRECV is specified, SCONTROL must 
also be specified. 


CHECKING 

the VRC/LRC checking feature on the 2740 Communication 
Terminal. 


KBRDLOCK 

the lock option capability for the 2848 Display Control 
Unit Models 21 and 22. 


SCONTROL 

the station control feature on the 2740 Communication 
Terminal and on the System/7 with ACCA. 


FSTTERM=name 

specifies the name of the first terminal on the line. The 
operand prevents the default assembler name being given to the 
first DFHTCT TYPE=TERMINAL macro* 

The FSTTERM operand and the label parameter in DFHTCT 
TYPE=TERMINAL for the first terminal entry in the line group 
must be specified when the number of lines multiplied by 10 
plus the number of terminals multiplied by 10 is greater than 
9999. This will prevent duplicate labels from being generated 
in large terminal control tables. 

Note that the FSTTERM and POOLADR operands are mutually 
exclusive. 


GENPOLL=YES 

must be specified for a multipoint binary synchronous 
communication line if one or more of the polling sequences in 
the DFTRMLST macro instruction is a general poll sequence. If 
this operand is used, the POLLPOS operand must be included in 
each DFHTCT TYPE=TERMINAL specification associated with the 
| line. For TRMTYPB=2980 or 3600, and remote 3270 devices, 

GENPOLL=YES is the default. 


ISADSCN=name 

specifies the input BSAM data set control name for a particular 
communication line. This data set control name must be the 
same name as that specified in the DSCNAME=name operand of the 
related DFHTCT TYPE=SDSCI macro instruction. This operand is 
applicable to BSAM, SAM, and Sequential only. This operand 
does not apply when CONSOLE is specified as a device. 


LINSTAI= *0UT OF SERVICE* 

indicates that the line is to be initiated with an "out of 
service” status. The default is ”in service.” 
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LISTADR=name|[,WRAP] 

specifies the name of the BTAM define—terminal-list macro 
instruction (DFTRHLST) in which the user has specified a 
polling list for the communication line. Use of the prefixes 
,, DFH ,, r “NIB", and "TCT 11 in the label could cause assembly 
errors. DFTRMLST entries should be coded immediately preceding 
DFHTCT TYPE=LINE entries or immediately following DFHTCT 
TYPE=TERMINAL entries. One separate DFTRMLST must be coded for 
each communication line on a switched network. A terminal must 
not be specified more than once in a polling list. 

name 

indicates the name of the label of the DFTRHLST macro 
instruction. 


WRAP 

indicates that a wraplist was specified in the DFTRMLST 
macro instruction. The default is an open list. 

LISTADR is only applicable when ACCMETH=BTAM. 

If ANSWRBK=EXIDVBR is specified, the LISTADR operand must 
specify the name of a DFTRMLST macro instruction of the 
SWLST,AN format. The user data portion of the entries in this 
list must be either of the following: 

1. The name of the corresponding DFHTCT TYPE=TERMINAL macro 
instruction for each 3275, 3735, and 3740; or 

2. Hexadecimal zeros for terminals that share the line with 
the 3275, 3735, or 3740 but do not transmit unique ID 
seguences. 

For a dial-up line containing 3275s, 3735s, 3740s, and other 
binary synchronous devices, the answering list must be coded as 
follows: 


symbol DFTRMLST SWLST,AN,xx,4,yy,zz, * 

(authseguence,0,userdata) * 

(2D,0,ZERO) 

where: symbol is the user name specified by 

the LISTADR operand of the DFHTCT TYPE=LINE 
macro instruction 

and ,xx,yy,zz are as defined in the BTAH manual, 
(authseguence,0,userdata) 
is a sublist in the answering list 
for each 3275, 3735, or 3740 in which: 
authseguence is as defined in the BTAM manual, 

0 must be specified for the control value, 

and userdata is the name of the DFHTCT TYPE=TBRHINAL entry. 
(2D,0,ZER0)is a sublist in the answering list for all 
non—3275/3735/3740 devices on the line where: 

2D is the ID ENQ sequence for non—3275/3735/3740 devices, 
0 must be specified for the control value, 

and ZERO is the name used to represent user data — 

(the following statement must be coded: ZERO EQU 0) . 
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Notes: 


1* For 2260 remote BTAM support, the polling list must specify 
a general pool. In this form of operation, achieved by 
coding X'FF* as the second byte of a single polling list 
entry # all display stations connected to the display 
control unit (identified by the first character of the 
polling list entry) are polled. 

2. Polling list entries for remote non—dial 3270 displays must 
specify a general poll. The use of a general poll allows a 
single entry in the polling list to invite input from all 
devices attached to each remote control unit or display 
station* 

In this form of operation, the polling list should contain 
only one entry for each 3270 control unit or for each 3270 
display on the line. For 3270 systems, this form of 
operation is achieved by using a device address code of 
X•7F* (EBCDIC) or X*22 # (ASCII) in each polling list entry 
applicable to a 3270 control unit or 3270 station. For 
remote 3270s, see the discussion of GENPOLL in this section 
and the discussion of POLLPOS in DFHTCT TYPE=TERMINAL 
below. For Teletypewriters (WTC only), a DFTRMLST macro 
instruction should be used with the WTTALST operand. 

3* Manual dial—out (55D) is not supported in CICS/VS. 

For more information, see BTAB—ES Programming or OS/VS 
Basic Telecommunications Access Method. 


NPDELAY=number 

signifies negative poll delay which specifies the interval of 
time, in milliseconds, between line polls (invitations) when a 
negative response to a poll is detected. This number can be 
specified in the range 0 to 20000, with default values varying 
by device type. NPDELAY is only applicable to start/stop and 
binary synchronous devices, but may not be specified for lines 
that use WRAPLST, AUTOWLST, or SSAWLST. 

When used with a TCAM line, this parameter specifies the time 
interval that is to expire before control is passed to DFHTEP 
when a CICS/OS/VS task is not ready to accept a record from an 
input process queue. 

If the CICS/OS/VS task issues a read before the time interval 
expires, processing continues normally and DFHTEP is not 
notified. The default value is zero. 


OSADSCN=name 

specifies the output BSAM data set control name for a 
particular communication line. This data set control name must 
be the same name as that specified in the DSCNAME=name operand 
of the related DFHTCT TYPE=SDSCI macro instruction. This 
operand is applicable to BSAM, SAM, and Sequential only and 
does not apply when CONSOLE is specified as a device. 
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POOLADR=symbolic-address 

must be used for switched—line processing and for the local 
3270 Information Display System. For switched—line or local 
3270 processing, this operand specifies the label assigned to 
the first terminal description macro (DFHTCT TYPE=TERMINAL) 
associated with a particular pool of communication lines or 
local 3270s. However, POOLADR should only be specified for the 
first line in a given line pool; FEATURE=AUTOANSR must also be 
specified. 

The POOLADR and FSTTERM operands are mutually exclusive. 

For a Teletypewriter (WTC only) line, this operand specifies 
the name assigned to the terminal description (DFHTCT 
TYPE=TERMINAL) associated with this line. 


RDYM SG=symbolic—address 

specifies the symbolic address of the ready message used by 
CICS/YS to communicate with terminals attached to the 7770 
Audio Response Unit. The ready message is required when 
TRMTYPE=7770 is specified and is defined through the DFHTCT 
TYPE=7770MSG macro instruction. (See "Digital Response 
Messages for the 7770 Audio Response Unit” later in this 
section*) 


TCTUAL={0|length} 

specifies the length, in bytes (0 to 255), of the process 
control information field (PCI) for all terminal entries 
(TCTTEs) associated with this line. The default is TCTUAL=0. 
The TCT user area length is initialized to zeros at system 
initialization. 

If fields of different (variable) lengths are desired, the 
TCTUAL value can be specified in one or more DFHTCT 
TYPE=TERMINAL macro instructions for terminals associated with 
this line. In any case, the PCI field is generated for each 
terminal after the last terminal entry of the last line. The 
address of the PCI field is located at TCTTECIA; the length is 
located at TCTTECIL. 

For CICS/OS/YS, PCI fields of fixed length (15 bytes) and/or 
variable length (0 to 255 bytes) can be specified by the TCTUA 
operand of the DFHSG TYPE=IilITIAL macro instruction. In the 
case of a fixed—length PCI field (the address of which is 
located at TCTTECI), the TCTUAL operand need not be specified. 
In the case of a variable—length PCI field (the address of 
which is located at TCTTECIA), the TCTUAL operand should be 
specified in DFHTCT TYPE=LINE and/or in DFHTCT TYPE=TERMINAL. 


TRMM0DL={model|character} 

This operand specifies the model number of the terminal 
associated with this communication line* This operand must be 
used if the device is one of the following: 

• Component of the 1050 Data Communication System 

• 2740 Communication Terminal Model 2 

• Component of the 2980 General Banking Terminal System 

• Component of the 3270 Information Display System 
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• 2260 Display Station 

• 2265 Display Station 

The TRMMODL parameter sets the default value that will be 
taken, when it is not specified in the DFHTCT TYPE=TERMINAL 
macro instruction associated with that line. If models vary on 
a line, the macro instruction can have a TRMMODL parameter 
associated with it which is different from that specified in 
the DFHTCT TYPE=LINB. This will override the DFHTCT TYPE=LINE 
macro instruction for that DFHTCT TYPE=TERMINAL macro 
instruction. 

model 

TRMMODL=1 is used to specify the 2980 Teller Station Model 
1, or 3270 Model 1 displays and printers TRMM0DL=1 is the 
default for the 3270 Information Display System and 
indicates 3270 displays and printers with a default screen 
or buffer width of 40 characters. 

TRMMODL=2 is used to specify the 2740 Communication 
Terminal Model 2, 2980 Administrative Station Model 2, or 
3270 Model 2 displays and printers with a default screen or 
buffer width of 80 characters*. 

TRMM0DL=4 is used to specify the 2980 Teller Station Model 

4. 

TRMMODL=5 is used to specify component polling of the 
keyboard for the 1050 Data Communication System using 
nonswitched communication lines. Component selection 
character 5 (0B) must be coded in the polling list 
(DFTRMLST). 

TRMM0DL=6 is used to specify component polling of reader 1 
for the 1050 Data Communication System using nonswitched 
communication lines. Component selection character 6 (0D) 
must be coded in the polling list {DFTRMLST). 

TRMMODL=7 is used to specify the component polling of 
reader 2 for the 1050 Data Communication System using 
nonswitched communication lines. Component selection 
character 7 (0E) must be coded in the polling list 
(DFTRMLST) . 

TRMMODL=0 is used to specify an input component for the 
1050 Data Communication System. Common polling character 0 
(15) must be coded in the polling list (DFTRMLST). 

TRMMODL=0 is the default specification for a 1050 Data 
Communication System* 


character 

The TRMM0DL=character operand is used to specify the 
applicable screen format for a 2260/2265 display station as 
follows; 


SPECIFICATIONS SCREEN FORMAT 


DEVICE 


TRMMODL=A 

TRMMODL=B 

TRMM0DL=C 

TRMM0DL=D 

TRMM0DL=E 


6x40 

2260 

12x40 

2260 

12x80 

2260 

15x64 

2265 

12x80 

2265 
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For example, TRMMODL=A specifies a 2260 Display Station 
with a 6x40 screen format. 

Not e: When TRMMODL is specified, the user must also 

specify the component selection character with control unit 
address through the TRMADDR operand of the DFHTCT 
TYPB=TERMINAL macro instruction. 


CICS/OS/VS Only 


OUTQ=symbolic—name 

is required in all TCAM input process queue terminal control 
table line entries. The symbolic name identifies the 
corresponding TCAM output process queue TCTLB. Multiple input 
process queues may reference the same output process queue. 


P00L=YES 

specifying POOL=YES on the TCAM output process gueue indicates 
that the TCAM POOL feature is supported for that TCAM line. 
Before using this parameter, the user should analyze the POOL 
feature restrictions discussed in "The CICS/OS/VS TCAM 
Interface” in Chapter 5.3 of this manual. 


?OOLCNT=number 

specifies the number of terminal control table line entries 
(TCTLEs) to be included in the pool of TCTLEs for a line group 
comprised of local 3270 Information Display Systems. The pool 
of TCTLEs is used by CICS/OS/VS to support concurrent 
operations on the BTAM local line group. 

The number of TCTLEs specified should reflect the expected 
activity on the local line group and the anticipated maximum 
number of concurrent requests. For a local line group 
containing printers, the number specified should be the actual 
number of printers plus one, to avoid locking out any screen 
keyboards when all printers are busy. 

When a READ or WRITE for a particular 3270 is issued, 

CICS/OS/VS allocates the first available TCTLB from the pool. 
This TCTLB is freed when the operation at the device is 
complete. For WRITE operations at a printer, the operation at 
the device is considered complete when the printing operation 
is complete. For CICS/OS/VS, local 3270s can be arranged in 
line groups in any desired manner. 

CICS/OS/VS supports as many concurrent operations on the line 
group as there are TCTLEs in the pool. If no TCTLB is 
available to support a reguested operation, the request remains 
pending until a TCTLB becomes available. 

Note: This is a required parameter for CICS/OS/VS using local 

3270s. 
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QUEUEID=hexadecimal—number 

is used to specify a unique user ID for the TCAM process queue. 
The ID is an untrained, one byte hexadecimal number (00 to PF) 
which is placed in the input and output line entry at TCTLEQID 
to provide queue identification while executing a user exit. 


TCAMFET=SNA 

must be specified if TCAM SKA devices are to be used on this 
line. The same DFHTCT TYPE=LINE macro must not include 
specifications for TCAM SNA and non—SNA devices. Specifying 
TCAMFBT=SNA allows TCAM SNA devices to be used in conjunction 
with the TRMTYPE/SESTYPE combination of operands in DFHTCT 
TYPE=TERMINAL to generate logical units. This operand is 
required if SNA support (for example, FMH) is to be supplied by 
BMS or by DFHDIP. 


SHARED TCTTE INFORMATION — DFHTCT TYPE=REGION 


The DFHTCT TYPE=REGION macro introduces information about the named 
region. The information consists of DFHTCT TYPB=LINE and TYPE=TERMINAL 
macros which follow the DFHTCT TYPE=REGION macro. Every terminal that 
can participate in transaction routing must be defined. Only certain 
DFHTCT macro types and operands are relevant in remote region 
definitions, all others will x>e ignored. The operands that are relevant 
are those listed on the DFHTCT TYPE=REMOTE macro definition. 

i-1-1-1 

| |DFHTCT | TYPB=REGION | 

| | | ,SYSIDNT= {name|LOCAL} I 

i-1-1-«— ---1 


TYPE=REGI0N 

indicates that the terminal control information that follows, 
refers to the named region. 


SYSIDNT={name(LOCAL} 

indicates the four-character name of the region whose 
information starts or resumes here. The name of the home 
region (that is, the region in which this terminal control 
table will be used) is the value of the SYSIDNT operand of the 
DFHTCT FYPE=INITIAL macro. SYSIDNT=LOCAL may be specified to 
indicate that the definitions following it refer to the home 
region, as do all definitions preceding the first DFHTCT 
TYPE=REGION macro. 


| REMOTE TERMINAL ENTRIES - DFHTCT TYPE=REMOTE 

I 

| Terminal entries for remote systems or regions can be defined to CICS/VS 
| using the DFHTCT TYPB=RBMOTE macro instruction as an alternative to 
| defining them using DFHTCT TYPB=rERMINAL macro instructions in 
| conjunction with a DFHTCT TYPB=BEGION macro. 

| With the exception of the SYSIDNT and RMTNAME operands, the details 
| for the operands for the DFHTCT TYPE=REMOTE macro are as described in 
| DFHTCT TYPB=TERMINAL• 
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Tne expansion of the DFHTCT TYPE=REMOTB macro instruction is 
independent of the region currently referenced. 


1 

IDFHTCT 

«■ 1 --■■■ 1 1 " " " "" 

| TYPE=PiEMOTB 

“"1 


i 

| ,ACCMETH=access—method 



i 

| ,SYSIDNT=name 




| ,TRMIDNT=name 



i 

| ,TRMTYPE=terminal—type 



i 

j [,ALTPGE= (lines,columns) ] 



i 

| [ r ALTSCRN= (lines,columns) ] 



i 

| [,ALTSFX=number3 



i 

| [,DEFSCRN=(lines,columns)3 



i 

| [ ,ERRATT= {NO | ([ LASTLINE ][ ,INTENSIFY ][ , {BLUE | RED 



i 

| | PINK | GREEN|TURQUOISE | YELLOW | NEUTRAL) ][,{BLINK 



i 

| | REVERSE | UNDERLINE) )) } ) 



i 

| [,FEATURE= (£eature[,feature),...)] 



i 

| [ ,OPERRSL={0| (number[ ] 



i 

| [ ,OPERSEC= Q| (number[ ,number ],...)} ] 



i 

| [,PGESIZE= (lines,columns) ] 



i 

| [,RHTNAKE=name] 



i 

| [,TCTUAL=number3 



i 

| [,TIOAL={value|(value 1,value2)} ] 



i 

i 

I [,TRMMODL=numbercharacter) 

i 



1 

i 

i 

1 

1 Non—VTAM 



I 

i 

1 

| [,DISMSG=name3 



i 

| [,LPLEN={132 lvalue) 3 



i 

| [ ,STN2980=number3 



i 

■ 

| [,TAB2980={0lvalue) 3 

• 



I 

i 

1 VTAH and TCAM SNA Only 
| 



1 

i 

| [,BMSFEAT= (FKHPARH,NOROUTE,NOROUTEALL,0BFHT,OBOPID)3 



i 

| [ ,HF={NO|YES) 3 



i 

| [,LDC={listname| (aa[=nnn3,bb[=nnn3,cc[=nnn3»•••)}] 



i 

| [,SESTTPE=session-type3 



i 

i 

1 [ r VF={NO | YES) 3 

1 



1 

i 

t 

1 VTAM Only 

t 



1 

i 

| [ ,FF= {NO | YES) 3 


1_ 

•_ 

_i- 

_1 


TYPE=REMOTE 

identifies this entry in the TCT as defining a terminal in the 
named region. 

SYSIDNT=name 

specifies the name of the system or region that owns this 
terminal. The name must be the same as that used in the 
SYSIDNT operand of DFHTCT TYPE=SYSTBM or T YPB= INITIAL. 

RMTNAMB~name 

j specifies the 1— to 4—character name by which the terminal is 

known in the system or region that owns the terminal. If this 
operand is omitted the name in the TRMIDNT operand is used. 

I Notes ; The other operands of DFHTCT TYPE=TERMINAL are valid (except 
| COMPAT and C0NSL1D) , but will be ignored if the SYSIDNT operand 
indicates a remote region. 
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The COMPAT and CONSLID operands are not valid because 2260 
compatibility and OS/VS operator console are not supported by 
transaction routing. 

If the SYSIDNT operand indicates that the terminal is owned by the 
home region then all the operands become valid and have the same meaning 
as for TYPB=TERMINAL. 


DATA SET CONTROL INFORMATION — DFHTCT TYPE=SDSCI 


For sequential, TCAM, and BTAM terminals, the user can specify data set 
control information through the DFHTCT TYPE=SDSCI macro instruction, 
which causes the operating system to generate the appropriate data set 
control information. DFHTCT TYPE=LINE and DFHTCT TYPE=REMOTE macros are 
also required. DTF information is generated in C1CS/DOS/VS; DCB 
information is generated in CICS/OS/VS. 

Two DFHTCT TYPE=SDSCI macro instructions must be generated for each 
sequential terminal. One macro instruction is for the sequential input 
data set and the other macro instruction is for the sequential output 
data set. This input/output data set combination simulates the input 
and output functions of a terminal. One DFHTCT TYPE=LINE macro 
instruction must be generated for this I/O combination. 

| One DFHTCT TYPE=SDSCI macro must be generated for each TCAM 
| input/output queue. Further details on TCAM and terminal control macros 
| can be found in Chapter 5.3. 

One DFHTCT TYPE=SDSCI macro instruction must be specified for each 
BTAM line group, where a line group is a group of communication lines 
which meet the following operational requirements: 

• All lines in the group are attached to the channel through the same 
type of telecommunications control unit; for example, a 2701. 

(This is true only for CICS/DOS/VS.) 

• The line connection between the control unit and the remote devices 
is of the same type; for example, a switched network. 

• All devices within the line group have the same line features and 
operating characteristics; for example, autopoll. 
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r 

i' 

~r 

I 


IDFHTCT 

| TYPB=SDSCI 



i 

j [,DEVICB=device] 



i 

| [ ,DSCNAME=name] 



i 

| [,BLKSIZE=length] 



i 

1 T,BSC0D£=(EBCDIC 1 ASCII) ) 



i 

| [,E0M=code) 



i 

| [ t EOT=code] 



i 

| [ ,ERR0PT={[N]|[E][E][W][C]}[T] 



i 

| [ , LERBADR=symbolie—address] 



i 

a 

| [,MONDLY=10|number] 

| 



1 

1 

1 

1 

1 CICS/DOS/VS Only 



! 

| [,CONFIG={PPT|MPT}] 



i 

I [,CU={2701|2702|2703|2848|3272|7770}] 




| [,DEVADDR=SYSnnn] 



i 

| [ ,FEAT0RB= (featuref ,feature ],...)] 



i 

| [,LINBLST= (nnn[,nnn],...)] 



i 

| §>JMODELST= (code[ ,code, ... ]) ] 



i 

| [,EETEY={7|number}] 



i 

| [,SWITCH={NO|YES}] 



i 

• 

| [ ,TEEMTST= {NO | YES} ] 



1 

i 

i 

1 CICS/OS/VS Only 

1 



1 

i 

| [,APPBNDG=xx] 



i 

1 r,DDNAME= f name—in—DSCNAME1 name)1 



i 

| [,FLNNAME=name] 



i 

| [ ,MACRF=([R][ ,W ]) ] 



i 

| [ ,MODE= ([ CNTEL ], {A |B} , {A | B} ) ] 



i 

| [ ,OPTCD={W|WIJ|WC|WDC|0|C|OC} ] 




| [,BECFM={0|F|V}] 



i 

j [,SYNAD=symbolic—name] 


L 

i_ 

_i- 

_1 


Note : Questions regarding terminal control table parameter selections 
may be clarified by referring to the TCT Configurator at the beginning 
of this section. 


TYPE=SDSCI 

specifies data set control information* 


DBVICE=device 

specifies the valid device types for this data set in the 
terminal control table. One of the following may be chosen: 

1050, 1403, 1404, 1442 (as a card reader only), 1443, 1445, 
2260, L2260, 2265, 2314, 2501, 2520, 2540, 2560 (as a card 
reader only), 2596, 2740, 2741C (with correspondence code), 
2741E (with PTTC/BBCD code) , 2770, 2780, 2980, 3203, 3211, 
R3275, L3270, L3270P, R3270, E3270P, 3275, 3277, L3277, 3284, 
L3284, 3286, L3286, 3330, 3340, 3350, 3505, 3525 (as a card 
reader only), 3600, 3660, 3735, 3740, 3780, 5203, 5425 (as a 
card reader only), 7770, BSCMDHPT, BSCBDPPT, BSCMDSH, CONSOLE 
(CICS/DOS/VS only), DASD, DISK, FBA (CICS/DOS/VS only), SIS/3, 
SYS/7, S370, S/7BSCA, TAPE, TLX, TW33, TW35, TCAM (CICS/OS/VS 
only) . 

L2260 signifies "local video attachment." 

2260 and 2265 signify "remote video attachment." 
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I 

I 

I 

I 

I 

I 


I 


I 

I 

I 

I 

I 

I 


Support for the 1053 printer is automatically included when any 
of these devices (2260, L2260, 2265) are specified. 

L3270 and L3270P signify "local 3270 attachment.” L3270 
indicates 3277 or a local 3284, 3286, 3278, and L3270P 
indicates a local 3287, 3288 or 3289. 

R3270 indicates a remote 3277 or 3278 

R3270P indicates a remote 3284, 3286, 3287, 3288 or 3289. 

B3275 indicates a remote 3275. 

3600 specifies binary synchronous nonswitched multipoint 3600 
devices. 

BSCEDPPT signifies "mixed binary synchronous point—to—point 
devices. 11 

BSCMDSW signifies "mixed binary synchronous switched devices." 

BSCMDEPT signifies "mixed binary synchronous multipoint 
devices." 

For direct access devices, either the device type or the 
generic parameters DASD or DISK may be specified. 

The TAPE specification generates tape worK files for both the 
input and the output data sets. Note that if an input tape 
with an expired label is used, the header may be rewritten, 
causing the first data records to be destroyed. 

The S/7BSCA specification is the System/7 with Binary 
Synchronous Communications Adapter. 

TCA8 (CICS/OS/VS only) causes CICS/OS/VS to generate the 
appropriate data set control information to handle the TCAH 
input or output process queue. 

Notes : 

1. When the 3660 is used with VSE, ENOTEs will be issued in 
the following circumstances: 

— SWITCH=YES will be assumed if not specified explicitly. 

- If CONFIG^HPT is specified, CONFIG=PPT and SWITCB=YES 
will be assumed. 

2. In generating a TCAM—only system, the following operands in 
DFHTCT TYPE=LINE do not apply: FEATURE, BSCODE, ANSWRBK, 
CONVTAB, COEPAT, 8TAERLN, ISADSCN, OSADSCN, and LISTADR. 

3. DEVICE=L3270P or R3270P also generates support for the 3288 
printer. 

4. The table at the end of Appendix D provides guidance on how 
to specify TRETYPE values for some 3270 devices. Where 
appropriate, the corresponding DEVICE option may be 
specified in the TYPE=LINB macro. 
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DSCHAMB=name 

specifies the symbolic data set control name associated with 
the data set control information. 

The DSCNAME for the sequential input data set must be the same 
name as that specified in the ISADSCN=name operand of the 
DFHTCT TYPE=LINE macro instruction. The DSCNAME for the 
sequential output data set must be the same name as that 
specified in the OSADSCN operand of DFHTCT TYPB=LINE. 

The DSCNAME for BTAM data sets must be the same name as that 
specified in the DSCNAME operand of DFHTCT TYPE=LINE. This 
operand is not required for console terminal support under 
CICS/DOS/VS. 


BLKSIZB=length 

specifies, for sequential data sets, TCAM queues, and 7770 
Model 3s, the maximum length (in bytes) of a block. 

For CICS/OS/VS, tne default is BLKSIZB=0. If this operand is 
omitted, the block size can be specified in the data definition 
(DD) statement associated with the data sat. A more detailed 
explanation of this operand is given in OS/VS Data Management 
Macro Instr u ctions . 

For CICS/DOS/VS, the default is BLKSIZE=80. A more detailed 
| explanation of this operand is given in VSE/Advanced Functions 

I Macro Reference * 

For 7770 Model 3s this value should be the same as that 
specified for INAREAL in the line entries that reference the 
DSCNAME of this DFHTCT TYPE=SDSCI macro instruction. 

For TCAM queues, the block size value must specify the maximum 
length that any CICS/VS application program will require to be 
written in one request. Mote that CICS/VS application programs 
include the master terminal command. A block size of at least 
2024 bytes (one screen size plus attribute bytes) should be 
specified. 


BSCODE={EBCDIC|ASCII} 

specifies the type of binary synchronous transmission code. 
The default is BSCODE=EBCDIC. 

EBCDIC 

indicates transmission in Extended Binary Coded Decimal 
Interchange Code. 

ASCII 

indicates transmission in American Standard Code for 
Information Interchange. 


| E0M=code 

| identifies the EOM (end of message) signal recognized by a 

| Teletypewriter (ETC only). 

| EOM=WRU 

I indicates that the WRU signal (FIGS D) is used to separate 

| incoming messages. EOM=JfRU is the default option. 
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EOM=X , hh l (where # hh f is the hexadecimal representation of FIGS 

x) 

is used only when FIGS x is not set in the World Trade 
Telegraph Adapter (WTTA) as FIGS D. 

EOM=X•hhlF* (where •hh* is the hexadecimal representation of 
FIGS y set in the WTTA) 

indicates that the FIGS y LTRS termination is used as end 
of message. 


EOT=code 

identifies the EOT (end of transmission) signal recognized by a 
Teletypewriter (WTC only). 

E0T=2E0M 

indicates that two consecutive BOM signals are defined by 
the user as end of transmission* 

EOT=X•hhlF• 

specifies that the FIGS y LTRS termination is used as end 
of transmission. Therefore, EOM^X^hlF 1 cannot be used as 
an end of message signal* 

Rote : In the above descriptions of the BOtt and EOT operands, x 

and y are the values assigned by the user. 


BRROPT= {[ N ] | [ E £; R ][ W }[ C ]} [ T ] 

specifies the error recovery, error recording, and online test 
options to be provided for the line group. The applicable 
keyword parameters are: 

C 

specifies that threshold error counts and cumulative error 
counts are to be maintained in the line error recording 
block (LERB) for the line for data check, intervention 
required, and non—text timeout errors. This parameter is 
applicable only to CICS/OS/VS. For CICS/DOS/VS, the LERB 
support is generated if the LERBADR parameter is specified. 

E 

specifies that the basic error recovery procedures are to 
be provided for the line group. If ERROPT is omitted, 
ERROPT=E is assumed. 


specifies that no error recovery procedures are to be 
provided for the line group. This parameter and B,R,W, and 
C are mutually exclusive* This parameter is invalid for 
binary synchronous stations; if coded, it is ignored. For 
Teletypewriters (WTC only), N is the default. 


specifies that text—read errors are to be retried in 
addition to the basic error recovery procedures. This 
option is only valid for the following terminals: 1050 
terminals (valid for the card reader and paper tape reader 
only if the line correction feature is installed), 2740 
terminals with the checking feature, and 2260 terminals. 
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specifies that error recovery is to be performed with "read 
text retry” and ”write text retry.” 


T 

specifies that the online test facility is to be used for 
the line group. Applicable only to CICS/OS/VS, this 
parameter is valid for all IBM terminals with or without 
error recovery capability. 


W 

specifies that text—write errors are to be retried in 
addition to the basic error recovery procedures. This 
option is valid for start/stop terminals. It results in an 
additional copy of the message for each retry (except for 
the 2260 with line address feature, and the 1050 card punch 
and paper tape punch with the line correction feature). 

This parameter is ignored for binary synchronous terminals. 

Notes ; 

1* For CICS/OS/VS, EROPT is also a valid spelling of this 
operand. 

2. Commas must not be coded in this operand. For example, 
ERROPT=RECWT. 

3. ERROPT is not valid for TCAM devices because error recovery 
is performed in the message handler. 


LBRBADR=symbolic-address 

specifies the label of the BTAM line error recording block 
(LERB) which the user creates by means of the BTAM 1 LERB 1 macro 
instruction. LERB is also a valid spelling. 

Notes : 

1. For CICS/OS/VS, this parameter should not be specified 
unless ERROPT=C is also specified. 

2. This parameter should not be specified for local terminals 
(2260L or 3270L) . 


| M0NDLY={JO|number} 

| specifies the number of mark characters to be sent to a 

j Teletypewriter (WTC only) when this terminal is not equipped 

I with the Motor—On optional feature. The default is MONDLI=10. 


C ICS/POS/VS Only 


C0NFIG= {PPT | MPT} 

specifies the type of binary synchronous line configuration. 
The default is CONFIG=PPT. 

PPT 

indicates that the data link between the processor and the 
remote binary synchronous device is point-to-point. 
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HPT 


indicates that the data link between the processor and the 
remote binary synchronous devices is a multipoint link. 

Note: MPT should be specified for terminals using the 

multipoint procedure even if there is only one terminal 
installed at that line. (Por example, a 3270 display on a 
nonswitched line.) See BTAM—ES Programming for additional 
information. 


CU={2701|2702|2703|2848|3272|7770} 

defines the control unit attached to the channel. 2701, 2702, 
2703, 2848, 3272 or 7770 may be specified. This operand is 
required for all nonsequential devices. CU=2701 is specified 
for a System/370 Model 135 with an ICA with start-stop or BSC 
devices attached. CU=2703 is required for Models 115, 125, or 
138 with an ICA. 


DEVADDR=SYSnnn 

specifies the symbolic unit address (sequential device) used 
for sequential terminal data sets. This operand is not 
required for CICS/DOS/VS console terminal support; SISLOG will 
be used* 


FEATURE=(feature[,feature ],...) 

specifies device—dependent machine special features and 
programming special features. The applicable keyword 
parameters are: 


APL 

specifies that the autopoll feature is to be employed for 
the start/stop devices. If FEATURE=APL is omitted, the 
generated channel programs for these devices will perform 
the standard programmed polling. A more detailed 
explanation of this code is given in BTAM—ES Programming . 

BSC 

must be specified when the DEVICE operand specifies a 
binary synchronous device. 


CHK 

specifies that the 2740 or System/7 with ACCA is equipped 
with the checking feature (CHK must always be specified for 
the System/7.) 

I AM 

specifies that a Teletypewriter (WTC only) can ask for the 
computer identification by sending FIGS D. 

KBL 

specifies that the 2848 control unit is equipped with the 
data entry feature. The Lock optypes are rejected as 
undefined if this parameter is not used. 
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MAS or SLV 

may be used to specify whether the processor is to be 
Master (MAS) or Slave (SLV) when contention occurs in a 
binary synchronous processor—to—processor contention system 
(private line). If this operand is not used, FEATURE=MAS 
is assumed for this system. 

If FEATURE=MAS is specified, the remote device is to be the 
slave when contention occurs. If FEATURE=SLV is specified, 
the remote device is the master. When the remote device is 
the 2780, FEATURE=SLV must always be specified. The 
processor must always be the slave when contention occurs 
between the processor and the remote 2780. 

MON 

specifies that the Teletypewriter (WTC only) is equipped 
with the motor-on optional feature. 

RIX, RXW, or RIW 

may be used if ID verification for an answering operation 
is to occur in a binary synchronous point—to—point dial 
system. A more detailed explanation of these codes is 
given in BTAM—ES Programming . (See Note 1, below.) 

SIX, SXW, or SIW 

may be used if ID verification for a calling operation is 
to occur in a binary synchronous point—to—point dial 
system. A more detailed explanation of these codes is 
given in BTAM—ES Programming . (See Note 1, below.) 

STC 

specifies that the 2740 or System/7 with ACCA is eguipped 
with the station control feature. 

WHO 

specifies that both a Teletypewriter (WTC only) and the 
computer can request each other 8 s identification by sending 
FIGS D. When WRU is specified, IAM is assumed. If neither 
IAM or WHO are specified, no exchange of identification can 
be performed. 

Notes : 

1. The SIX, SXW, SIW, RIX, RXW, and RIW parameters should not 
be used with expanded ID verification, that is, they should 
not be included if ANSWRBK=EXIDVER is specified in the 
DFHTCT TYPE=LINB macro. 

2. In CICS/OS/VS, IAM, WRU, and MON are part of the 
appropriate BTAM DCB. For additional information, refer to 
the BTAM—ES and OS/VS BT AM manuals. 


LINBLST= (nnn[ ,nnn], •..) 

specifies the correspondence between symbolic unit (SYSnnn) and 
relative line number. The user codes one three-digit number 
(nnn of SYSnnn) for each line in the line group. The order in 
which the three-digit numbers are coded determines which 
symbolic units are associated with the individual lines in the 
line group. As many as 32 three-digit numbers from 000 through 
244 may be specified in this operand. 

For local 3270s and local 2260s, each number entry represents a 
physical device. 
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MODELST=(code[code],...) 

is used to specify a code (0, 1, 2 r or 3) for each line in a 
binary synchronous line group to be used by BTAM at OPEN time. 
For example, a line group comprised of 5 lines coded as: 

MODELST=(,1,,3,) would assign a code of 1 to line 2, 3 to line 
4 and 0 (default) to lines 1, 3 and 5. CICS/DOS/VS does not 
support the use of codes 4, 5, 6, and 7. A more detailed 
1 explanation of this operand is given in BTAM—ES Programming . 

If converting from CICS/DOS/VS to CICS/OS/VS, this operand must 
be recoded to MODE. 


RETRY= {7| number} 

specifies the number of retries (0 to 15) by BTAM for 
recoverable errors which occur on I/O operations for binary 
synchronous communication. The default is RETRY=7• 


SWITCH^ {NO|YES} 

specifies the type of line connection between the system and 
the remote device. The default is SWITCH=N0. 

NO 

indicates that the line connection is dedicated. 

YES 

indicates that the line connection is through a switched 
network. 


TERMTST={NO|YES} 

specifies whether the online terminal test facility is to be 
used. The default is TERMTST=NO. 

NO 

indicates that online terminal test is not to be used. 

YES 

indicates that online terminal test is to be used. 

| A more detailed explanation of this operand is given in BTAM—ES 

I Programming . For CICS/OS/VS, the online terminal test facility 

is specified through the £RR0PT=T operand. 


CICS/OS/VS Only 


APPENDG=XX 

applies when DEVICE=7770 is specified. This operand is used to 
specify a two—character alphameric suffix for the 777 0 channel 
end/abnormal end appendage routine. The suffix specified must 
be in the range WA to Z9 and must be the same suffix as 
specified in the CAA operand of the DFHSG PROGRAM=CSO macro 
instruction. 


DDNAME-name 

supplies the name of the data definition (DD) statement 
associated with a particular data set (line group). If this 
operand is omitted, the DSCNAME becomes the DDNAME• 
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FLRNAME=name 

specifies, for CICS/OS/VS only, the name of the first 
communication line entry that is defined by the DFHTCT 
TYPE=LINE macro instruction for local 2260s. 


MACRF= ([*],[» 3) 

specifies how access to the BTAM line group or to sequential 
devices is to be gained. 

R 

indicates the READ macro instruction. 

W 

indicates the WRITE macro instruction. 

The default for BTAM line groups is MACRF=(R,W); the OPEN 
option for BTAM line groups defaults to input. For sequential 
devices (other than card reader and line printer), MACRF=R or 
MACRF=W must be specified. The default is MACRF=R for a card 
reader and MACRF-W for a line printer. 


M0DB= ([CNTRL], (A |B} , {A|B}) 

specifies the mode of communication for a binary synchronous 
line group. Note that because CICS/VS does not support the IBC 
parameter described in OS /IS Basic Telecommunications Access 
Method , a leading comma must be used. 


A 

specifies that communications are to be through the 2701 
Data Adapter Qnit*s Dual Communication Interface A. 

B 

specifies that communications are to be through the 2701s 
Dual Communication Interface B. This parameter must not be 
coded if this feature is not present on the 2701. 

A 

specifies use of the transmission code A for 2701 Data 
Adapter Unit Dual Code Feature. 

B 

specifies use of the transmission code designated by Code B 
for 2701 Dual Code Feature. This parameter must not be 
coded if this feature is not present on the 2701. 

CMTRL 

should be specified if the central computer is to be given 
control when contention occurs on a point-to-point 
nonswitched line. It should be omitted if the remote 
station is to be given control. 


I OPTCD-{W|WU|WC|WUC|U f C|UC} 

specifies the optional fields for the TCAM work unit. 

C 

specifies that a one—byte field in the work area, called 
the position field, indicates whether the work unit being 
handled is the first, an intermediate, or the last segment 
of the message, and, on input, whether a record delimiter 
has been detected in the data. 
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u 

specifies that the work unit to he handled is either a 
message or a message segment which is not a record. If U 
is omitted, the work unit is assumed to be a record. 

w 

for input, specifies that TCAM is to place the name of the 
source of each message in an eight—byte origin field in the 
work area. If OPTCD=W is omitted, the TCAM user must 
himself ensure that a source name is placed in the origin 
field. 

For output, specifies to TCAM, that the name of the 
destination of the message will be placed in an eight—byte 
destination field in the work area before a TCAM WRITS 
macro is executed. CICS/VS always inserts a destination 
name. If OPTCD=W is omitted, the TCAM user must provide 
for interpretation of the destination field. 

For further information on the OPTCD operand, see the OS/VS 
TCAM Application Programmers Guide * 


RECFM={U|F|V} 

| specifies, for sequential data sets and TCAM, the record format 

for the DCB• The default is RECFM=U. 

U 

indicates undefined records. This option must be specified 
| for DEVICE=1403 or 3211, and for TCAM queues used by 

| CICS/VS. 

F 

indicates fixed—length records. 

V 

indicates variable—length records. 

If this operand is omitted, the record format can be specified 
in the data definition (DD) statement associated with the 
sequential data set. 


SYNAD=symbolic—name 

is applicable only to CICS/OS/VS with TCAM and specifies the 
address of a subroutine that is to be given control if message 
processing is used, if the work unit is larger than the work 
area, or if OPTCD=C is not specified. 

For input queues, a user—written SYNAD routine can be specified 
for which an EXTRN is generated. If SYNAD is not specified, a 
CICS/OS/VS generated SYNAD routine is provided. If CICS/OS/VS 
SYNAD is used and the exit occurs: 

1. Message DFH4000 is issued. 

2. The DCB is closed. 

3. The DCB is reopened. 

4. Data is truncated to the specified block size and is passed 
to the CICS/OS/VS application program. 
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INTERCOMMUNICATION LINKS - DFHTCT TIPE=SYSTEM 


The DPHTCT TYPE=SISTEM macro instruction generates the CICS/VS control 
blocks that are required when defining the route to, and means of 
communication with, a remote system or region when the CICS/VS 
intercommunication facilities are being used. 

This macro is a replacement for the DFHTCT TIPE^ISLINK macro used in 
earlier releases. 

The macro generates a system entry (TCTSE) that describes the remote 
system and, optionally, one or more terminal entries (TCTTEs) that 
define the sessions between the systems or regions. The system entry*s 
name (SYSIDNT) is the name used in the SYSIDNT operands of the DCT, FCT, 
TCT, PCT, and TST, and on EXEC requests to remote systems or regions. 

The sessions with the remote system or region may be defined in a 
number of ways: 

1. By specifying DFHTCT TYPE=SYSTEM with the SEND or RECEIVE operands. 
In this case, a set of TCTTEs using the TCTTE operands specified 
will be generated. The TRMIDNT operand will be ignored. The 
SESTYPE operand cannot be specified. 

2. By specifying the TRMIDNT operand, a single TCTTE using the TCTTE 
operands specified will be generated. The SEND and RECEIVE 
operands must be omitted. 

3. By specifying a series of DFHTCT TYPE=TERMINAL statements following 
the TYPE=SYSTEM macro, each with the same SYSIDNT name as in the 
DFHTCT TYPE=SYSTEM macro. The statements with SESTYPE=RECEIVE must 
precede those with SESTYPB=SEND. The TCTTE operands in the 

TYPE=SYSTEM will be ignored. 

The second method is supported only when the remote system is CICS/VS 
Version 1, Release 4 or Version 1, Release 4.1. The other two methods 
will work with a remote system of CICS/VS Version 1, Release 4 or 
Version 1, Release 4.1 but only with extra flows at session initiation. 
Thus, the second method should be used if the remote system is known to 
be Version 1, Release 4 or Version 1, Release 4.1 and is expected to 
remain so; the first and third methods have advantages if the remote 
system is not CICS/VS Version 1, Release 4 or Version 1, Release 4.1 or 
is about to be upgraded to Version 1, Release 5. 

The first method is the only one allowed for the multiregion 
operation (MRO) facility (ACCMETH=IRC) . 

Further details on the CICS/VS intercommunication facilities can be 
found in Chapter 3.5. 

The following syntax display shows the TCTTE operands that can be 
used for the automatically generated set of sessions, if any. 


292 


CICS/VS System Programmer^ Reference Manual 




1 

I label 

|DFHTCT 

| TYPB=SY STEM 

-1 

1 

1 

i 

| ,ACC HETH= {VTAtt|IRC|INDIRECT} 



1 

i 

| ,SYSIDNT=name 


1 

1 

! 

| [,INDSYS=name] 



1 

1 

| [,NETNABE=name] 


1 

1 

1 

| [ ,RECEIVE= (prefix!,number 1) ] 


1 

1 

1 

1 

1 

| [,SEND= (prefix2,number2)] 



1 

1 

1 

1 

1 

1 

l 

1 TCTTE Operands 

1 



1 

1 

1 

1 

| [,BUFFBR=buffer-size] 


1 

1 

1 

| [,CHNASSY={NO|YBS)] 



1 

1 

| [,COHHECT=AOTO] 


1 

1 

1 

| [,DATASTR= ({USER|3270|SCSISTRFIBLD|LBS}) } 



1 

1 

| [,OPERID=operator—identification-code] 



1 

1 

| [,OPERPRI=operator—priority—code] 


1 

1 

1 

| [,OPERRSL={0|nunber}] 



1 

1 

| [,OPERSEC=security—key—number] 


1 

1 

1 

| [,RECFB={0|VB}] 



1 

1 

| [,RUSIZE=size] 



1 

1 

| [,SESTYPB={SEND)RECEIVE} ] 



1 

1 

| [,TCTUAL=num ber] 


1 

1 

1 

| [,TI0AL= {value|(value 1, value 2) } ] 



1 

1 

| [ ,TRBIDNT=name] 



1 

1 

| [ ,TRBPRTY=number] 



1 

1 

| [ ,TRBSTAT= (status[ ,status],... ) ] 


1 

1 

1 

| [ ,XSNABE=value] 



i_ 

_i_ 

_L 

_a 


label 

is optional and may be used to indicate a one— to eight— 

| character name that identifies the DPHTCT TYPE=SYSTBM macro 

being generated. 


| TYPE=SYSTEM 

indicates that an intercommunication link is to be defined. 


| ACCMETH={VTA!!| IRC | INDIRECT} 

| indicates the access method to be used on this link session. 

| VTAN 

| indicates that VTAH is to be used to control data passed 

| between CICS/VS systems in the same domain or cross domain. 

| IRC 

I indicates that intercommunication is to take place between 

| CICS/VS regions within the same processing unit, using the 

j multiregion operation facility. 

| Only the SEND, RECEIVE, TRHSTAT, OPERPRI, OPERSEC, OPBRRSL, 

| TIOAL, TRMPRTY, and XSNAME operands may be specified with 

| ACCttBTH=IRC• 

INDIRECT 

indicates that intercommunication with the named region 
will be via the system named in the INDSYS operand. 
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SYSIDNT=name 

provides a one— to four-character alphanumeric name to identify 
the intercommunication link* This name must also be specified 
in the SYSIDNT operand in DFHDCT TYPE=REMOTE, DFHFCT 
TYPE=REMOTE, DFHPCT TYPE=REMOTE, or DFHTST TYPE=REMOTE for a 
remote entry unless the name is specified in an explicit remote 
request by an application program. If the NETNAME operand is 
omitted, SYSIDNT must satisfy the requirements that apply to 
NETNAME. 


BUFFER and RUSIZE 

indicate the buffer size and request unit size to be used for 
this TCTTE. A non—zero BUFFER size must be specified because 
this is transmitted to the connected system and is used as the 
RUSIZE value. For further information on BUFFER and RUSIZE, 
refer to the DFHTCT TYPE=TERMINAL macro description. 


DATASTR= ( {USER|3270|SCS|STRFIELD|LMS} ] 

specifies the type of data stream. The default is 
DATASTR=USER . 

USER 

specifies that the data stream is user defined. 

3270 

specifies that the data stream is a 3270 data stream as 
defined in the type 6 logical unit (LU6) architecture. 

SCS 

specifies that the data stream is an SCS data stream as 
defined in the LU6 architecture. 

STRFIELD 

specifies that the data stream is a structured field data 
stream as defined in the LU6 architecture. 


LMS 

specifies that the data stream is a Logical Message 
Services (LMS) data stream consisting of FMB4s and FMH8s as 
defined in the LU6 architecture. 


INDSYS=name 

indicates that name of a remote system which will be used to 
relay communication between this system and the remote system. 
This operand must only be specified if ACCMETH=INDIRECT is 
specified. The name specified in this operand must be the same 
as the name specified for the SYSIDNT operand in a DFHTCT 
TYPE=SYSTEM macro with ACCMETH=VTAM or IRC. 


NETNAME=name 

provides a unique one— to eight—character alphanumeric network 
name that identifies the remote CICS/VS system or region to 
| ACF/VTAM or IRC, and is the same name as that specified in the 

APPLID operand of DFHTCT TYPE=INITIAL in the remote system or 
| region. For ACF/VTAM this is the same name as that specified 

| for the label of the remote ACF/VTAM VBUILD TYPE=APPL 

| statement. The default for NETNAME is the name specified in 

the SYSIDNT operand. 

| All IRC system entries must have a different NETNAME specified. 
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RECEIVE=(prefixl,number1) 

indicates that the intercommunication link is to be used for 
VTAM parallel sessions or IRC sessions. If the RECEIVE and 
SEND (see below) operands are specified, there is no need to 
write a DFHTCT TYPE=TERMINAL statement for each parallel 
session if there are no essential differences between the 
sessions. If the RECEIVE, SEND, and TRMIDNT operands are not 
specified, at least one DFHTCT TYPE=TERMINAL macro must be 
written to describe the session. 

For IRC sessions, the RECEIVE operand must be specified. 

The SESTYPE operand may not be used if the RECEIVE operand is 
specified. 

prefixl 

indicates a two-character prefix that will be used to 
represent the first two characters of the TRMIDNTs of the 
terminal entries. 

number1 

is a number in the range 1 through 99, which will be used 
to indicate the number of parallel sessions that will 
usually receive before sending. The number specified will 
be used to generate last two characters of the TRMIDNTs for 
the terminal entries, starting at 1 and increasing by one 
up to the value specified. 

For IRC, RECEIVE sessions can only receive before sending. 


RBCFM= (U | VB} 

specifies the type of SNA chain. The default is RECFM=U. 

U 

specifies that only the SNA chain is an understood message. 
The user may have private block algorithms within the SNA 
chain. 

VB 

specifies that the SNA chain is formatted according to the 
VLVB standard as defined in the LU6 architecture. 


SEND= (pref ix2,number2 ) 

indicates that the intercommunication link is to be used for 
VTAM parallel sessions or IRC sessions. If the RECEIVE (see 
above) and SEND operands are specified, there is no need to 
write a DFHTCT TYPE=TERMINAL statement for each parallel 
session if there are no essential differences between the 
sessions. If the RECEIVE, SEND, and TRMIDNT operands are not 
specified, at least one DFHTCT TYPE=TERMINAL macro must be 
written to describe the session. 

For IRC sessions, the SEND operand must be specified. 

The SESTYPE operand may not be used if the SEND operand is 
specified. 

prefix2 

indicates a two—character prefix that will be used to 
represent the first two characters of the TRMIDNT of the 
terminal entry. 
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| number2 

| is a number in the range 1 through 99, which will be used 

| to indicate the number of parallel sessions that will 

| usually send before receiving. The number specified will 

| be used to generate last two characters of the TRMIDNTs for 

| the terminal entries, starting at 1 and increasing by one 

j up to the value specified. 

| For IRC, SEND sessions can only send before receiving. 


| SBSTYPB={SESD| RECEIVED 

| indicates that a CICS/VS Version 1, Release 4 level 

conversation (sending a request to a remote system, which 
executes the request and sends a reply bach to the original 
system) is to be established. The conversation ends when the 
remote system sends the reply, except when recoverable 
resources are accessed, in which case, the conversation lasts 
| until the next sync point. In both cases, no other 

| conversation can start on the session that has been used, until 

| the current one has ended. 

| The RECEIVE and SEND operands may not be used if the SESTYPE 

| operand is specified. 

SEND 

indicates that the system may start a conversation at any 
time (if there is not one currently in progress). This 
option should be specified for the system that is likely to 
initiate most of the conversations. 

RECEIVE 

indicates that the system must ask the other system for 
permission to start a conversation. The other system may 
refuse and can start a conversation of its own. 


TIOAL={value| (value 1,value2)} 

If ACCMETH=IRC is specified, only one value may be specified 
| for this operand. This value is the minimum size of the TIOA 

| to be used by the corresponding IRC session. 

For details of this operand when ACCMETH=IRC is not specified, 
refer to the description in the DFHTCT TYPE=TERMINAL macro. 


TRMIDNT^name 

| indicates the four character name by which the automatically 

| generated TCTTE for the single intercommunication link between 

| the systems will be known. The operand is not used when either 

| the SEND or RECEIVE operand is specified or when session TCTTEs 

I are generated explicitly by subsequent DFHTCT TYPE=TERMINAL 

j macro instructions (see anove). 


TRHSTAT-(statusf,status ),...) 

indicates the status of the terminal entries generated by the 
| TYPE=SYSTEM macro. The usual status is TRANSCEIVE. Refer to 

the TRMSTAT operand in DFHTCT TYPE=TERMINAL for details of the 
other types of terminal status. 

| For ACCMETH=IRC, the only status which may be specified is •OUT 

| OF SERVICE 1 . 
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XSNAME=name 

specifies the 1 — to 8 —character external security 
identification of the remote system or region. 

For ISC connections, XSNAME specifies the external security 
identification of the remote system that will be used by the 
external security facility to check resources required by the 
remote system. 

For MRO, XSNAME specifies the external security identification 
that the remote system must have for the connection to be made. 
If the remote system's external security identification does 
not match the value specified for XSNAME, then the connection 
will be rejected. If XSNAME is not specified, then a 
connection will be made to the remote system regardless of its 
external security identification. 

The remaining TCTTE operands (listed in the syntax display) are as 
described in the DFHTCT TYPE=TERMINAL macro. 


TERMINAL TYPES — DFHTCT TYPE=TERMINAL 


| The terminals or intersystem communication sessions in the system are 
described to CICS/VS by the DFHTCT TYPE=TERMINAL macro instruction. The 
expansion of this macro instruction includes the terminal control table 
| terminal entry (TCTTE) for terminals in the local region. 

| For VTAM logical units, the VTAM BIND area is generated from the 
TCTTE. This includes values for the RUSIZE and BUFFER parameters. 

| The DFHTCT TYPE=LINE and DFHTCT TYPE=SDSCI macros do not apply to 
| VTAM terminal entries, or, for OS/VS only, to console terminal entries. 

For BTAM or TCAM terminal entries, the terminal definitions must 
immediately follow the corresponding line entry (DFHTCT TYPE=LINE). The 
sequential terminals (TRMTYPE=CRLP, DISK, or TAPE) support only one 
| entry per line. 

A DFHTCT TYPE=TERMINAL macro instruction must be written for each 
terminal on a line. For single—dropped and multidropped terminals on 
nonswitched lines, the DFHTCT TYPE=TERMINAL macro instruction must 
immediately follow the DFHTCT TYPE=LINE macro instruction. The DFHTCT 
TYPE=TEBMINAL macro instruction entries must be contiguous for 
multidropped terminals on nonswitched lines and for terminals in a 
terminal pool on switched lines. For Teletypewriters (WTC only), one 
DFHTCT TYPE=LINE and one DFHTCT TYPE=TERMINAL macro instruction should 
be specified for each line attachment in the system. 

| DFHTCT TYPE=TERMINAL macro instructions may be used immediately after 
| a DFHTCT TYPE=SYSTEM macro instruction to describe a set of parallel 
| sessions, but see comments under 'Intercommunication Links — DFHTCT 
| TYPE=SYSTEM 1 in this chapter. 

The following operands can be used in the DFHTCT TYPE=TERMIHAL macro 
instruction. Note that the optional operands for this macro are 
arranged in the following order in the syntax display: 

| • Operands that apply to BTAM, BGAM, TCAM, and VTAM 

• Non—VTAM operands 

• Operands that may be used with VTAM or TCAM SNA devices 
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• VTAM—only operands 

| • CICS/OS/VS—only operand 

to allow the user to identify the operands which apply to his own system 
on an access method basis. The descriptions of the optional operands 
are presented alphabetically after the description of the required 
operands. 
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|label 

IDFHTCT 

| TYPE=TERMINAL 


1 

1 

| 9 TRMIDNT=name 


1 

1 

1 ,TRttTYP E= ftype—specified—in—TY PE=LINE1 type! 


1 

1 

1 f.ACCMETB=fmethod-specified-in-TYPB=LINBIVTAM!1 


1 

1 

I [,ALTPGE= (lines,columns) 3 


1 

1 

| [,ALTSCRN=(lines,columns) 3 


1 1 

1 

j [,ALTSFX=number3 


1 

1 

| [,BUFFER=buffer-size3 


1 

1 

| [,DEFSCRN= (lines,columns)3 


1 1 

1 

| f ,ERRATT= (NO 1 ([ LASTLINE }[ ,INTENSIFY 3[ , (BLUE |RED |PINK | 


1 1 

1 

| GREEN|TURQUOISE|YELLOW|NEUTRAL} 3[, {BLINK|REFERSE| 


1 1 

1 

| UNDERLINE} 3) } 3 


1 

1 

| [,FEATURE= (featuret ,f eature 3, • • •) 3 


1 1 

1 

| [ ,LASTTRM= {LINE | POOL} 3 


1 

1 

| [,OPERID=operator—identification-code 3 


1 

1 

| [,OPERPRI=operator—priority—code 3 


1 1 

1 

| [ ,0PERRSL={0| (numberf ,...}} 3 


1 1 

1 

| [ ,OPERSEC={1.| (number[ ,... 3)) 3 


! 

1 

| [,PGESIZE= (lines,columns) 3 


1 

1 

| [,PGESTAT={AUTOPAGB|PAGE} ] 


1 1 

1 

| [,RMTNAME=name3 


1 

1 

1 T.TCTUAL=fnumber—specified—in—TYPE=LINE1 number) 1 


1 

1 

| [,TIOAL={value|(valuel,value2)}3 


1 

1 

| [,TRANSID=name3 


1 

1 

1 r,TRMHODL=fnumber—specified—in—TYPE=LINBI 


1 

1 

| numbercharacter}3 


1 

1 

| [ ,TRMPRTY={0| number} 3 


1 

1 

1 

1 

1 T ,TRMSTAT= {TRANSACTION 1 (statusr .status!. ...)!! 

1 


1 

1 

1 

1 

• 

1 Non-VTAH 
• 


1 

1 

1 

1 

1 r.CLASS=fclass—specified—in—TYPE=LINB1 (rC0NV1 BATCH 1 


1 

1 

| [ , VIDEO | HARDCOPY | AUDIO 3[ ,BISYNC 3) } 3 


1 

1 

| [,COMPAT={NO|(characters,lines,device.model,F2260)} 3 



1 

| [,DISMSG=name3 


1 1 

1 

| [ ,LPLEN= {120 lvalue} 3 


1 1 

1 

| [,LVUNIT=number3 


» 

1 

| [,POLLPOS=number3 


1 

1 

| [,STN2980=number3 


1 

1 

| [,TAB2980={0lvalue}3 


1 

1 

1 

1 

| [,TRMADDR={address|name}3 

| 


1 

1 

1 

1 

1 

t 

1 

1 VTAM and TCAM SNA Only 

i 


1 

1 

I 

1 

! 

| t ,BHSFEAT= (FMHPARM,NOROUTE,NOROUTEALL,OBFMT.OBOPID) 3 


1 

1 

| [,HF={NO|YES}3 


1 

1 

| [,LDC={listname| (aa[=nnn3,bb[=nnn3,cc[=nnn3,«••)}3 


1 

1 

l r.NETNAME={name—specified—in—TRHIDNT1 name! 1 


1 

1 

j [,SESTYPE=session—type3 


1 

1 

1 

I 

1 r . VF= (NO 1 YES) 1 

1 


1 

1 

1 

1 

1 

1 

1 VTAM Onlv 

1 


1 

1 

1 

1 

| [,ALTPRT= (labelf,COPY 3)3 


1 

1 

| [ ,BRACKET={YES|NO} 3 


1 

1 

| [ ,CHNASSY={NO| YES} 3 


1 

1 

| [,CONNECT=AUTO} 


1 

1 

| [ ,FF = {N0|YES} 3 


1 

1 

| [,GMMSG={NO|YES}} 


1 

1 

| [,LOGMODE=name3 


1 1 


| [,NETNAMQ=name3 


1 

1 

| [ ,PIPELN= {LAST | POOL} 3 


! 

1 

| [ ,PRINTTO= (labelf ,COPY3) 3 



i-1-1-1 
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1 I I t r DUTDl?n- # nan I VOC1 fMAIVPO \ I I 



1 

| [,RBLBEQ= ({NOfYBS},{NO|YES}) ] 



1 

1 [,R0SI2E=f256lvalue!1 



1 

| [,SYSIDNT=name] 



1 

| [,TASKHO=number] 



I 

1 

1 

1 

1 CICS/OS/VS Only 



1 

1 

1 

| [,CONSLID={ALL|number}] 



I-1-1_I 


Note: Questions regarding terminal control table parameter selections 
may be clarified by referring to the TCT Configurator at the beginning 
of this section. 

label 

provides a one— to eight-character name for the DPHTCT 
TYPB=T£RMINAL macro being generated and must oe specified on 
the DFHTCT TYPE=TERMINAL macro which identifies the first 
terminal in a pool of switched terminals or local 3270s, and on 
a 3270 printer referenced by PRINTTO or ALTPRT (see these 
operands below). It is optional otherwise. If used in this 
manner, "label” should be the same as that used in the POOLADR 
operand of DFHTCT TYPE^LINE. 


TYPE=TERMINAL 

| specifies a terminal for the current region. 


TRMIDNT=name 

supplies a unique four—character symbolic identification to 
I each terminal. The name is also used as the local half of a 

| session qualifier pair in a CICS/VS intercommunication parallel 

| session. The TRMIDNT parameter and the destination 

identification in the destination control table, when 
applicable to terminal destinations, must be the same. 

The identification supplied will be left—justified and padded 
with blanks to four characters if less than four characters are 
| supplied. The default for TRMTYPE=CONSOLE (OS/VS only) is 

| CNSL• 


TRMTYPE and SESTYPE 

Support for VTAM and TCAM SNA logical units is generated by 
specifying the appropriate TRMTYPE/SESTYPE combinations 
described in the following table. 

For BTAM and TCAM devices, the TRMTYPE operand (without the 
SESTYPE operand) can be used to specify the terminal type: 

1. If the terminal type has not already been specified in the 
DFHTCT TYPE=LINE macro instruction, or 

2. To override the type specified in that macro instruction. 

| The parameters for non—VTAM devices are the same as described 

| for the TRMTYPE operand of the DFHTCT TYPE=LINE macro. 

In addition, TRMTYPE=CONSOLE can be specified in DFHTCT 
TYPE=TERHINAL under CXCS/OS/VS to provide support for the 
processing unit console to be used as a terminal under OS/VS. 
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1 

| Terminal 
| Subsystem 

i -- '• ■ ... — -■ -. 

| Logical Unit 

J TRHTYPE= 

| SESTYPE= 

1 

“i 

| 3270 

i 

| 3270 — Display station 

| 3275 

1 _ 




| 3270 1 

1 



| - Printer 

| 3270P 1 

| — 



| Logical unit type 2 2 

| L0TYPE2 

| — 



| Logical unit type 3 2 

| L0TYPE3 

1 — 



1 SCS printer 

| SCSPRT 

t 


| 36003 

| 3601 

| 3600 

I 



| 3614 

| 3614 

1 — 



| Pipeline 

| 3600 

| PIPELN 

i 


| 3650 4 

| Pipeline 

| 3650 

1 

| PIPELN 



| Host—conversational 

| 3650 

| 3270 



1 (3270) 


i 



| Host-conversational 

I 3650 

I 3653 



1 (3653) 


1 



| Interpreter 

| 36 50 

| 0SEBPBOG* 



| Host Command Processor 

| 3650 

| 0SEBPBOG 5 



1 (HCP) 


1 

1 


| 3767 

| Interactive (flip-flop 

| 3767,37671, 

1 



| mode) 

| or INTLU 

1 



| (contention 

| 3767C 

1 — 



| mode) 


1 

1 


| 3770 

| Interactive (flip-flop 

| 37701, 

I 



| mode) 

| or INTLU 

1 



| (contention 

| 3770C 

| — 



| mode) 


1 



| Batch (flip-flop mode) 

| 3770,3770B 

| — 




| or BCHLU 

1 



| Pull Function 

| 3770 or 3770B | 0SEBPBOG 



| Batch Data Interchange 

| 3770 

I 

| BATCHDI 

i 


| 3790 

| Full Function 

| 3790 

1 

| USERPROG 



| Inquiry 

| 3790 

1 — 



| Batch Data Interchange 

| 3790 

| BATCHDI 



| 3270—display 2 

| 3790 

| 3277CH 




| L0TYPE2 

| — 



1 3270—printer 2 

| 3790 

| 3284CM|3286CH 




| L0TYPE3 

1 — 



| SCS printer 

| 379 0 

| SCSPRT 




| SCSPBT 

a 


| 6670 

| Logical unit type 4 

1 

| LUTYPE4 

1 

1 

1 


| WTTY 

| TLX (LU1) (flip-flop) 

| TLX 

| INTL0 



| (contention) 

| TLX 

i 

| CONTL0 

1 


| TWX 

| TWX (LU1) (flip-flop) 

1 

| TWX 

| INTLU 


| model 33/35 

| (contention) 

| TWX 
• 

| CONTLU 

1 


(subsystem 

| LU6 session in a 

| L0TYPE6 

| SEND 


| supporting 

| subsystem 

1 

i 


| L06 


| L0TYPE6 

| RECEIVE 


» - 




—J 
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Notes: 


1. The recommended keywords for non—SNA VTAM 3270 devices are 
TRMTYPE=3270 and 3270P for displays and printers, respectively. 

The following keywords can also be specified and are retained for 
compatibility with previous releases: 

— Displays: 3277 and L3277 

— Printers: 3284 and L3284, 3286 and L3286 

For SNA VTAM 3270 devices use the LUTYPE2 or LUTYPE3 keyword as 
appropriate. 

2. The table in Appendix B gives some of the possible configurations 
for 3270 devices, some of which may be used to provide alternate 
screen size support. TRMTYPE and SESTYPE specifications are given 
for local, BSC, and SDLC connections. LUTYPE2 logical units are 
those defined by SNA, which accept a 3270—display data stream. 
LUTYPE3 logical units are those defined by SNA, which accept a data 
stream similar to that for a 3270 printer. TRHTYPE=L0TYPB2 may be 
specified for 3790 3270—compatible logical units, and 
TRMTYPE=LUTYPE3 may be used for 3270 printer logical units. 

3. TRMTYPE=3600 and TRMTYPE=3600,SESTYPE=PIPELN also generate support 
for the 3630 Plant Communication System logical unit. For further 
information on this subsystem, refer to the CICS/VS IBM 3600/3630 
Guid e. 

4. The 3650 subsystem is not supported under TCAM• 

5. The 3650 interpreter logical unit is generated with BRACKET=YES, 
and the 3650 host command processor logical unit is generated with 
BRACKET=N0• 


ACCMETH={method|VTAM] 

indicates which access method is to be used for this TCTTE. 
The default is the access method specified in the ACCMETB 
operand in DFHTCT TYPE=LINE• 

VTAM 

indicates that a Virtual Telecommunications Access Method 
TCTTE is to be created. 


ALTPGE- (lines,columns) 

indicates the page size to be used by BMS for this terminal 
entry when ALTSCRN has been selected as the screen size. The 
default is the value specified in ALTSCRN. 
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ALTPRT= (label[ ,COPY ]) 

specifies an alternative printer to be used only if the primary 
printer (specified in PRINTTO) is unavailable. The •label* 
parameter functions as for PRINTTO. PRINTTO must always be 
specified if ALTPRT is specified; otherwise ALTPRT is ignored. 

The specification of COPY in either PRINTTO OR ALTPRT means 
that CICS/VS will use the hardware ‘COPY* feature of the 3270 
to perform the print, unless a task is currently attached to 
the display. If only one of the PRINTTO and ALTPRT printers is 
on the same remote 3270 control unit as the display, this 
should be the PRINTTO printer, because this one will always be 
used if possible. FEATURE=COPY need not be specified for the 
screen from which the printout is requested, because this is 
implied by the COPY option on PRINTTO or ALTPRT. 

COPY must only be specified in PRINTTO or ALTPRT if the display 
(the terminal for which PRINTTO or ALTPRT are specified) and 
the printer (the terminal specified by PRINTTO or ALTPRT) are 
on the same 3270 control unit. If COPY is specified and the 
display and printer are on different control units, either the 
COPY option may fail and an error condition be raised or, if 
the display device address is valid for the printer*s control 
unit, copying might be performed from a different display. For 
a 3270 compatibility mode display, the COPY command is invalid 
and will be ignored if used. 

Note : In a networking environment, if the 3270 control unit is 

connected to a TCAM system in one domain and if a CICS/VS 
system in another domain has access to the control unit via 
VTAM, the COPY parameter must not be specified for the displays 
on that control unit, because the hardware copy address is not 
available to CICS/VS. 

It is unnecessary to specify FEATURE=PRINT in the DFHTCT 
TYPE=TERNINAL instruction for a printer specified in either 
PRINTTO or ALTPRT, because this is implicit when these operands 
are specified. 

If PRINTTO and ALTPRT are omitted, or the devices are 
unavailable, the ••unavailable printer 11 error condition will 
result. This implies that the printer (if specified) is in one 
of the following conditions: 

• Out of service 

• Task currently attached 

• Currently busy on a previous operation 

• Intervention required. 

Further information is given in the section on node error 
programs in Chapter 4.3 of this manual. 


ALTSCRN=(lines,columns) 

defines the 3270 screen size to be used for a transaction that 
has SCRNSZE=ALTERNATE specified in DFHPCT TYPE=ENTRY. The 
default is the value specified in the DEFSCRN operand. The 
values that can be specified are: 
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Device 


Alternate screen size 


3276-1, 

3278-1 

(12,80) 

3276-2, 

3278-2 

(24,80) 

3276-3, 

3278-3 

(32,80) 

3276-4, 

3278-4 

(43,80) 


3278-5 

(27,132) 

3279-2A, 

3279-2B 

(24,80) 

3279-3A, 

3279—3B 

(32,80) 


For 3287 and 3289 printers, the value specified must egual the 
buffer size of the particular device. 

Note that there is no validity checking performed on the screen 
size selected, and that incorrect sizes may lead to 
unpredictable results. 

For SNA devices (LUTYPE2 and LUTYPE3), it is possible to 
specify DEFSCRN with the same value as in ALTSCRN (that is, 
both with a screen size of 43,80). In this case, all 
transactions can run using the ALTSCBN size, and 
SCRNSZE-ALTERNATE need not be specified in DFHPCT. 

For non—SNA 3287 and 3289 printers, the sizes depend on the 
feature ordered, not on the model number. 

For SNA printers, there are no features, and any two sizes can 
be specified from the ••valid” list. 


ALTSFX=number 

indicates a one—character numeric suffix (specified in the 
SUFFIX operand of the application programmer*s DFHMSD 
TYPE={DSECT|MAP} macro). This suffix will be appended by BUS 
to mapset names if the screen size being used is the same value 
as the alternate screensize, that is, if the transaction has 
SCRNSZE=ALTERNATB specified in DFHPCT TYPE=ENTRY or if the 
default and alternate screen size are the same. In this case, 
BMS map selection routines will attempt to load the mapset with 
the suffix specified in the ALTSFX operand. If this operand is 
not specified or if the map is not loaded successfully, BMS 
will continue with its current processing (that is, attempting 
to use a mapset with the appropriate device suffix and an 
, unsuffixed mapset name.) 


BMSFEAT=(FMHPARM,NOROUTE,NOROUTEALL,OBFMT,OBOPID) 

indicates which BMS features will be used for this TCTTE. 

FMHPARM 

indicates that BMS is to accept user—supplied parameters 
for inclusion in the FMH built by BMS. The macro 
instruction should restrict this parameter to 3650 logical 
units. 

NOROUTE 

indicates that BMS is not to produce routed data for this 
terminal. This is the required specification for 3653 
terminals. 

NOROUTEALL 

indicates that BMS is not to include this terminal in the 
list of terminals to receive data in response to a BMS 
route request to all devices. This operand is never 
required, but may be specified for any terminal. 
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OBFMT 

indicates that BUS is to support outboard formatting for 
this terminal- The macro instruction should restrict this 
parameter to 3650 logical units which are capable of 
supporting outboard formatting. 

OBOPID 

indicates that the outboard operator identifiers will be 
used by CICS/VS in order to support the BBS routing 
facilities required for this terminal. This option only 
applies to the 3790 and 3770 batch data interchange 
(SESTYPE=BATCHDI) logical units. 

Bote: BMSFEAT does not apply to the 3790 inquiry logical 

unit, because there is no BBS support for this type of 
logical unit. 


BRACKET={YES|NO} 

specifies whether bracket protocol is to be enforced for this 
logical unit. 

YES 

indicates that bracket protocol is to be enforced. This 
option is required for the 3790 inquiry and full function 
logical units. (BRACKET=YES will be forced for all 
required sessions, including 3270 compatibility mode 
sessions if not specified explicitly.) BRACKET=YES must 
also be specified if any of the interactive logical unit 
parameters or batch logical unit parameters are specified 
in the TRMTYPE operand. 

NO 

indicates that bracket protocol is not to be enforced. 
BRACKET=NO must be specified for a 3614 logical unit and 
the 3650 Host Command Processor (HCP) session. 

Note: For a VTAH 3270, the entire session constitutes a 

bracket. Therefore, the BRACKET operand will be ignored on the 
DFHTCT TYPE=TERMINAL macro. 


BUFFER=buffer—size 

specifies the presence and size of the receive buffer for the 
indicated terminals and logical units. The following buffer 
sizes should be specified which correspond to the related 
hardware features installed. 
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Device buffer sizes 


Buffer Size 


2740 Model 2 

120 

248 

440 


2770 


128 

256 

512 


3780 

512 


2780 


MULTIREC 


Feature 


1499 — Buffer Receive 

1495 — Buffer Expansion 

1496 — Buffer Expansion 


(standard) 

1490 — Buffer Expansion 

1491 — Buffer Expansion, additional 


(standard) 


5010 — Multiple Record Transmission 


Note: BUFFER=MULTIREC should be specified for the 2780 with 

multiple record transmission. 


The default value is BUFFER=120 for the 2740 Model 2, 
BUFFER=128 for the 2770, B0FFER=512 for the 2780 and BUFFER=0 
for other devices. 


For 3600 BSC devices, BUFFER represents the maximum data length 
which the work station may receive. The value specified must 
not be greater than the size of the host read buffers of either 
the 3601 or of the work station. 

The unit of transmission from CICS/VS to the BSC 3601 is a 
segment. If an application program issues a WRITE for a message 
longer than the value in BUFFER, CICS/VS will break the message 
down into as many segments as necessary. The length of each 
segment (except the last) is equal to the value of BUFFER. The 
length of the last or only segment (in the case of a single 
segment message) is the length of the data still to be sent. 

Logical unit buffer sizes 

Buffer size represents the maximum data length that the logical 
unit can receive, and should be equal to the capability of the 
appropriate device. However, line quality considerations may 
dictate a smaller value, for devices with large buffers, than 
the actual buffer size. For further information, refer to the 
appropriate hardware component description manual. 

If a longer message is presented by an application program to 
be sent by CICS/VS, it is broken into as many request units as 
necessary. Each request unit has a maximum length equal to the 
buffer size specified. This length includes the FMH (if 
present) in the first request unit of the message. For 
recovery purposes, the complete message (that is, chain of 
request units) is treated as the unit of recovery. 

For 3270 compatibility mode logical units, the recommended 
buffer size values are: 
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TRMTYPE=SCSPRT 256 

TRMTYPE=LUTYPE2 1536 

(or TRMTYPE=3790,SESTYPE=3277C!1) 

TRMTYPE=LUTYPE3 256 

(or TRMTYPE=3790,SESTYPB=3284CM) 

The value specified in BUFFER will be transmitted to the 
connected logical unit. This value may be adjusted slightly by 
CICS/VS according to the value specified f because the value 
must be transmitted in an architected form. Thus, the value 
may be rounded down by CICS/VS before being transmitted. 

If zero is specified or assumed by default, no chaining takes 
place. The data sent is the same size as presented to CICS/VS 
by the application program. 

For LUTYPB6 logical units, a buffer size of at least 256 bytes 
must always be specified. Increasing the buffer size will 
cause more storage to be allocated for the session but may 
decrease the number of physical messages sent between the two 
nodes. 

Note: For 3270 logical units, BUFFER will always be set to 0 
by CICS/VS to prevent output chaining, which is not needed for 
these logical units. 


CHNASSY={NO|YES} 

specifies whether or not chains are to be assembled on input by 
terminal control before any processing is performed on any part 
of the chain. The default is NO. This operand may not be 
| specified for 3270 logical units (LUTYPEO). CHNASSY=YES will 

be forced for 3270 compatibility mode logical units. 

NO 

indicates that any input TIOA received by an application 
program from this logical unit will contain one request 
unit (RU) . 

YES 

indicates that any input TIOA received by an application 
program from this logical unit will contain a complete 
chain. 


| CLASS= (class—specified—in—TYPE=LINE I ([CONV|BATCH] 

| [ ,VIDEO | HARDCOPY | AUDIO ][ ,BISTNC ]) } 

indicates the device classification. The parameters are the 
same as those that can be specified for the CLASS operand in 
| DFHTCT TYPE=LINE and the default is the option chosen in that 

macro. 

This operand does not apply when CONSOLE is specified as the 
| device, or to devices connected through VTAH• 
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COI!PAT={NO|characters,linss,device,model,F2260} 

indicates that the 2260/2265 terminal or 1053 printer specified 
in the "device 11 parameter is to be simulated on the 3270 
Information Display System. The Keyword parameters are 
positional and must be replaced by a comma if they are omitted. 
The default is COMPAT=NO. 

2260 compatibility is not available for 3270s operating through 
VTAM or for 3270 compatibility mode logical units. In such 
cases this operand will be ignored and a non—error MNOTB will 
be produced. 

NO 

indicates that 2260/2265 or 1053 simulation is not 
required. 

characters 

specifies the screen size of the 2260/2265 terminal. The 
applicable parameters are 240, 480, and 960. 

lines 

specifies the number of lines applicable to the 2260/2265 
terminal or to insert new line (NL) symbols into the 
3284/3286 printer output data stream where NL symbols are 
not provided by the user in the output data stream. 
Applicable parameter values are 6, 12, and 15. The default 
value for a 960—character screen is 12. 

device 

specifies either a 1053, 2260, L2260, or 2265 terminal. 

The default is 2260. Note that the specification 
C0MPAT= (960,15) results in an error condition because the 
2260 (assumed by default) cannot support 15 lines. 

model 

specifies a model number for the 2260 terminal being 
simulated. This parameter provides an interface for any 
user—written application programs which currently test the 


TCTTEMN field before building 

device—dependent 2260 data 

streams. Any one 

character value may be specified for the 

model number. If 
(•FO*) is used. 

a value is 

not provided, a value of zero 

Model 

Specification 

Screen 

Format 

TRMM0DL=A 

6X40 

2260 

TRMM0DL=B 

12X40 

2260 

TRMM0DL=C 

12X80 

2260 

TRMM0DL=D 

15X64 

2265 

TRMMODL=E 

12X80 

2265 


F2260 

specifies FASTEN 2260 Compatibility support for the 3270 
terminal. 


Examples: COMPAT= (960,12,1053,C,F2260) 

COMPAT= (240,6,2260,A,F2260) 

For further information concerning the use of the COMPAT 
operand, see the section ”2260 Compatibility for the 3270" in 
Chapter 5.5 of this manual. 
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CON NECT=A UTO 

indicates that CICS/VS is to issue a VTAM SIHLOGON macro 
instruction automatically for this logical unit when CICS/VS is 
initialized. If this operand is not specified, this logical 
unit will not be logged on to CICS/VS at initialization and 
must be logged on by: 

• The logical unit itself 

• The master terminal operator, by acquiring the logical unit 

• The VTAtt network operator 

• VTAN (automatically) via START options 

• Automatic task initiation (ATI) . 

This operand must not be specified for 3790 inquiry logical 
units. 

Note : If the VTAM macro has ISTATUS=INACTIVE, the SIHLOGON 

issued during CICS/VS initialization will fail, and a CSMT 
ACQUIRE command will be required before the logical unit can be 
used by CICS/VS. 


DEFSCRN=(lines,columns) 

defines the 3270 screen size or page size to be used on this 
device when attached to a transaction for which SCRNS ZEDEFAULT 
has been defined in DFHPCT TYPE-ENTRY. The default is the 
value associated with the appropriate option in the TRMMODL ‘ 
operand• 

The values that may be specified in the DEFSCRN operand are: 


I 


Device 


Screen size 


I 3276-1, 3278-1 (12,40) 

| 3276-2, 3278-2 (24,80) 

| 3276-3, 3278-3 (24,80) 

| 3276-4, 3278-4 (24,80) 

| 3278-5 (24,80) 

3279—2A , 3279-2B (24,80) 

| 3279-3A, 3279—3B (24,80) 


For LUTYPB2 and 3 logical units, the value specified in DEFSCRN 
may be the same as that used in the ALTSCRN operand. 


DISMSG=name 

applies only to CICS/OS/VS support for World Trade Teletype 
terminals (TRHTYPE=TLX). ”name” indicates the label of the 
DFHTCT TYPE=TLXMSG macro, which identifies the message text 
that is to be written to the terminal when a DFHTC 
TYPEDISCONNECT reguest is issued. If the DISNSG operand is 
specified, a DFHTCT TYPE=TLXMSG macro with the corresponding 
name must be coded. If the operand is not specified, the 
message written in response to a DFHTC TYPEDISCONNECT request 
is "DFH2535 DISCONNECT REQUESTED”. 
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ERRATT= {NO | ([ LASTLINE ][ , INTENSIFY ][ , {BLUB | RED | PINK | GR EEN |TURQUOISE | YELLOW | 
NEUTRAL} ][ , {BLINK |REVERSE|UNDERLINE} ]) } 
indicates the attributes that are to be associated with error 
messages that are displayed on this 3270 screen. The default 
is ERRATT=NO. This will override the value of the ERBATT 
operand specified in a DFHTCT TYPE=INITIAL or TYPE=LINE macro 
instruction. 

NO 

indicates that an error message will be displayed at the 
current cursor position and without any additional 
attributes. 

LASTLINE 

indicates that an error message will be displayed starting 
at the beginning of the line nearest the bottom of the 
screen such that the message will fit on the screen. 

The other values indicate that one or more of the 3270 
attributes are to be used when an error message is 
displayed. Specification of any attribute implies 
LASTLINE. Valid attributes are: 


for field intensification: 
INTENSIFY 

for color: 

BLUE 

RED 

PINK 

GREEN 

TURQUOISE 

YELLOW 

NEUTRAL 

for highlighting: 

BLINK 

REVERSE 

UNDERLINE 


Any attributes specified that are not valid for this device 
will be ignored. 


FEATURE^(feature[,feature],...) 

specifies the applicable features for the 3270 Information 
Display System and corresponding 3284 Printer Model 3 on the 
3275 Display Station, the 2980 General Banking Terminal System, 
the 2770 Data Communication system, the 2780 Data Transmission 
Terminal, the 3600 BSC Finance Communication System, the 
System/3, and the System/7. 

| Further information on the features for 3270 devices can be 

| found in the CICS/VS IBM 3270 Guide . 


AUDALARM 

specifies the Audible Alarm feature for a 3270 or for a * 
3270 display/printer attached to a 3651 controller. 
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BtJFEXP 

specifies the Buffer Expansion feature (RPQ835503) for the 
2980 General Banking Terminal System. Applicable only to 
the first terminal entry of a control group, the BUFEXP 
parameter increases the station buffer size to 96 
characters. 


COLOR 

indicates that the 3270 device has the extended color 
feature, which allows colors to be selected for each field 
or character. 


COPY 

specifies that the Copy Feature for a 3270 display or" 
printer is included in the 3270 control unit. This option 
should not be specified for 3270 compatibility mode logical 
units, and will be ignored if specified. 

DCKYBD 

specifies the typewriter keyboard and/or operator console 
keyboard for a 3270 display. Both uppercase and lowercase 
data can be transmitted with either of these keyboards. 


EXTDS 

indicates that the 3270 device supports extensions to the 
3270 data stream. This option is implied if any one of the 
COLOR, HILIGHT, PS, or VALIDATION options is specified. 


HILIGHT 

indicates that the 3270 terminal has the extended highlight 
facility, which enables fields or characters to be 
displayed in reverse—video, blink, or underline mode. 


PRINT 

must be specified for BTAH—supported 3270 printers that are 
eligible to receive print requests. This feature makes the 
3270 printer eligible for print requests by means of the 
Program Access key from a 3270 display. In order to 
support print requests from a 3270 display, the remote 3270 
control unit must have the COPY option (see above). For 
local 3270*s, all terminal control table terminal entries 
for devices attached to the same local 3270 control unit 
must be generated on the same terminal control table 
SDSCI/LINE pair and a separate SDSCI/LINE pair must be 
generated for each local control unit. (See the PRINT 
operand in DFHSIT.) 


indicates that the programmed symbol (PS) facility can be 
used on this 3270. The facility enables up to six 191- 
character sets, with customer-defined and program—loaded 
fonts and codes, to be stored and accessed. 
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PTRADAPT 

For the 3275: specifies the Printer Adapter feature and 
corresponding 3284 Printer Model 3 on the 3275 Display 
Station. This feature makes the 3284 eligible for print 
requests through the Program Access key from the host 3275. 
A separate DFHTCT TYPE=TERMINAL macro instruction cannot be 
coded for the 3284 Printer Model 3, because this printer 
shares the buffer of the 3275 Display Station. 

For LUTYPE2 logical units: specifies that for print 
reguests initiated by the PRINT key or by a DFHTC 
TYPE^PRINT macro, printer allocation will be handled by the 
3790, or by the 3274 or 3276 according to the printer 
authorization matrix for both VTAM and non—VTAM 
attachments. Further, 3270 printers attached to the same 
3790 are available for print reguests sent to the 3270- 
display logical unit by a terminal control print request or 
initiated by the operator. If FEATURE=PTRADAPT is not 
specified, printer allocation is determined by the PRINTTO 
and ALTPRT parameters. 

Note: If output is created on the screen by DFHBMS or 

DFHMSD macros with CTRL=PRINT, by BMS requests with the 
NLEOM option, or by the CMSG command, the contents of the 
screen are automatically copied to a 3270 printer, whether 
the Program Access key was hit or not. 


SELCTPEN 

specifies the Selector Pen feature for a 3270 display. 


TRANSPARENCY 

specifies that terminal data is not to be translated on a 
read or write, allowing the sending or receiving of all 256 
bit combinations in a byte. This applies to the 2770, 

| 2780, S/3, S/370, S/7BSCA, and 3270 devices with extended 

| data stream support. 

UCTRAN 

specifies translation of lowercase data to uppercase in 
3270, 3767, and 3770 SDLC input data streams. If 0CTRAN is 
specified, the EBCDIC and/or ASCII parameters must also be 
specified in the UCTRAN operand of the DFHSG PROGRAM=TCP 
macro instruction. Only UCTRAN=EBCDIC is valid for 3270 
logical units. Translation can be overridden by the 
application program for specific READ requests. 

| Uppercase translation is not recommended for devices 

| supporting extensions to the 3270 data stream, and a 

| warning message will x>e issued if it is specified in the 

I TCT for such a device. No uppercase translation will take 

| place if an inbound structured field is received from a 

| 3270 device. 


VALIDATION 

indicates that the 3270 device has the extended validation 
feature, which allows fields to be defined as mandatory 
fill and/or mandatory enter fields. 

Information in the TCTTE provided by specifying the following 
features will not be used by CICS/VS, but may be of use to applications 
programs requiring information on the features available on particular 
devices. 
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3270K 

indicates that the device is one of the 3270 range having^ 
the alternate screen size facility (3276, 3278, 3279, 3287 
or 3289) • This option may not be specified for a 3287 
printer attached to a 3271 or 3272 control unit. 

APLKYBD 

indicates that the 3270 device has the APL keyboard 
feature. 

APLTEXT 

indicates that the 3270 device has the APL text feature. 
This option may not be specified for a 3288 printer (with 
or without the TEXTPRINT option, below). The APLTEXT 
feature is used in conjunction with the TEXTKYBD and 
APLKYBD options. 

TEXTKYBD 

indicates that the 3270 device has the text—keyboard 
feature. 

TEXTPRINT 

indicates that a 3288 printer has the text—print feature. 
This option may be used in conjunction with the 3270E 
option to indicate that the text—print feature will be used 
on a 3289 printer. 

For further information on the use of the FEATURE operand with 
2260 displays, see the section ”2260 Compatibility for the 
3270” in Chapter 5.5. 


FF={N0|YES} 

indicates whether the logical unit supports the Forms Feed (FF) 
SCS control character. The default is FF=N0• If FF=YES is 
specified, BBS will use this character when formatting output 
documents. This causes BBS to insert "FF" at the end of each 
page instead of the required number of NL characters to 
complete each page. If the device defaults from FF to NL, the 
position of the output data on the page may be incorrect. 


G»ilSG=N0| YES 

indicates whether the CIC5/VS "good morning" sign—on message 
will be displayed when the logical unit is signed on to VTAB• 
The default is GBMSG-NO. 


indicates that the "good morning" message is not required. 

YES 

indicates that the "good morning" sign-on message is to be 
displayed. This option causes transaction CSGB to be 
invoked , which runs when the OPNDST exit is successfully 
completed and a session is established. Note that 
transaction CSGM is initiated by means of automatic task 
initiation (ATI) and competes with other ATI—initiated 
transactions for use of the terminal. 
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HF= {NO | YES} 

indicates whether the horizontal forms feature is to be 
supported by the batch, batch data interchange, interactive, or 
LUTYPE4 logical unit. HF=NO will override the HTAB= (tab, .. .) 
parameter in the DFHMSD macro instruction. The default is 
HF=NO • 


| LASTTRM={LINE(POOL) 

indicates a "last terminal” condition. 

LINE 

applies to BTAM and BGAM nonswitched line processing 
(except local 3270) . 

POOL 

applies to BTAB switched—line processing and the local 3270 
Information Display System (non—VTAM) . It must be 
specified to identify the last terminal in the pool. 

When using TCAH, this parameter indicates the last terminal 
condition as follows: 

1. LASTTRM=LINE if POOL=YES has not been specified. 

2. LASTTRM=POOL for the last terminal in the pool if POOL=YES 
has been specified. 


LDC^listname | (aa[=nnn ],bb[ =nnn ],cc[ =nnn ], ...) 

indicates that this TCTTE points to a list of logical device 
codes (LDCs). The list is used to specify which LDCs are valid 
for this logical unit and, optionally, which device 
characteristics are valid for each LDC. The first LDC 
generated in this list is the default when CICS/VS must choose 
a default LDC for a logical unit. 

Note : This operand applies only to 3600, 3770 batch, 3770 and 
3790 batch data interchange, and LUTYPE4 logical units. 

listname 

specifies the name of the local LDC list or extended local 
LDC list to be associated with this logical unit. (This 
LDC list is generated by a DFHTCT TYPE=LDCLIST macro 
instruction or by a series of DFHTCT TYPE=LDC macros for 
the extended local LDC list.) 

(aa[ =nnn],bb[ =nnn],...) 

is used to generate a local LDC list that applies only to 
this logical unit. 

aa,bb,... 

is a list of two—character mnemonic LDCs. If BBS uses 
these LDC mnemonics, each LDC mnemonic specified must have 
a corresponding entry in an LDC list created by a DFHTCT 
TYPE=LDC macro instruction. 

nnn 

is a decimal value from 1 through 255 associated with this 
LDC. If no value is coded, the system default value from 
the table defined by DFHTCT TYPE=LDC is used. This value 
need not be specified for batch or LUTYPE4 logical units, 
but if it is, it must correspond to the device. LDC values 
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for devices attached to batch or L0TYPE4 logical units are 
listed under the LDC parameter of the DFHTCT TYPE=LDC 
macro. 


LOGMODE=name 

indicates a logmode name in the logon mode table that has been 
set up for use by this logical unit. This operand allows the 
user to override the BIND image provided by CICS/VS for the 
logical unit being generated. For further information, refer 
to the appropriate CICS/VS subsystem guide. 


LPLBN={120 lvalue} 

controls the length of the print line for SAM output line 
printers. If no NL symbols are found in a segmented write, the 
print line length is the LPLEN value. The default is LPL£N=120 
which is also the maximum value for TRftTYPB=CONSOLE (OS/VS 
only) . 


LVONIT=number 

specifies a decimal number from 1 to n which is used to 
identify the local video unit. For local 2260 or local 3270 
(BTAM-support only), n is a maximum of 32 (use of Assembler D 
restricts n to a maximum of 31). This operand is applicable 
only when TRMTYPE=L2260, TRMTYPB=L3277 (BTAM-support only), 
TRMTYPB=L3284 (BTAM-support only) , or TRMTYPE-L3286 (BTAM- 
support only) is specified. 

For CICS/DOS/VS, the LVUNIT specification indicates the local 
video unites relative position in the corresponding DFHTCT 
TYPE=SDSCI, LINELST=parameter specification. For CICS/OS/VS, 
the LVUNIT specification indicates the local video unites 
relative position in the concatenation of data definition (DD) 
statements for the corresponding DFHTCT TYPE=SDSCI 
specification. 


NBTNAME-networic—name 

indicates a one— to eight-character symbolic network name for 
the logical unit as it is known throughout the network. The 
name is supplied to VTAM system definition and is used to build 
the node initialization block (NIB) that represents this TCTTE 
in CICS/VS. When not coded for a VTAM TCTTE, the default is 
the logical unit f s identification padded with 4 blanks. (A 
non—error MNOTE is issued.) NETNAME must be specified for 
3614s. For TCAM devices, the name must be the same as that 
used in the TCAM TERMINAL macro. 


NETNAMQ=name 

specifies the one— to eight—character name by which the remote 
system knows this particular parallel session. This operand is 
only allowed for TCTTEs that follow DFHTCT TYPE=SYSTEM 
statements for parallel sessions. 


OPERID=operator—identification—code 

specifies the three-character operator identification code to 
be used when CICS/VS signs on. 
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OPERPRI=operator-priority—code 

specifies the operator priority code to be used when CICS/VS 
signs on. The code may be any value from 0 through 255. 


| OPERRSL= {01 (number[ ,...])} 

| specifies the resource security level to be set in the TCT for 

| a terminal or link if a sign—on is not to be performed. The 

| resource security level comprises one or more decimal values 

I from 1 through 24. This RSL value is checked with the resource 

| RSL value by transactions that require resource level security 

j checking. The default is 0. 


| 0PERSEC={!| (number[ ,... ]) 

specifies the security key for this TCTTE if sign-on is not 
performed by the terminal operator. The security key comprises 
| one or more decimal values from 1 through 24. The default is 

1 . 

Note : For the 3614, the OPERSEC operand allows a signed—on 
condition for a 3614 logical unit to be generated. The OPERSEC 
operand must be specified for a 3614 unless the 3614 
application program has a security key of 1. 

For the 3600 and 3650, the OPERID, OPERSEC, and OPERPRI operands are 
used to specify the CICS/VS operator sign—on parameters to be used with 
this terminal. These operands can only be specified if PIPELINE, 3270, 
or DSERPROG are specified in the SESTYPE operand. 

The above restrictions are enforced when the CICS/VS terminal control 
tanle is created. These operands are not applicable when defining a 
3650 host command processor (HCP) logical unit. 


PGESIZE= (lines,columns) 

indicates the default page size for this terminal. 

If the DEFSCRN operand is specified in this macro for a 3270, 
the value specified in PGESIZE supplies the page size to be 
used by BMS when DEFSCRN has been selected as the screen size. 
If the PGESIZE operand is omitted and the DEFSCRN operand is 
specified, the page size defaults to the value of DEFSCRN. 

Note : BMS uses the page size values when preparing output data 
streams. The specified number of characters in each line of ~ 
the page should not exceed the physical line width of the 
terminal. In the case of hard-copy devices that automatically 
perform a new—line function on reaching the end of the carriage 
(for example, 3270 printers), the line width specified in the 
operand should be less than the physical line width. This will 
ensure that the formatting of the output data is governed 
entirely by the new—line (NL) characters supplied by BMS or by 
the user, not by new—line functions performed by the device 
itself, which would produce additional lines of output, 
resulting in a physical page depth greater than that specified 
in this operand. 

lines 

indicates the number of lines in the page. 


316 


CICS/VS System Programmers Reference Manual 



columns 

indicates the number of characters in each line. 

If PGESIZE is not specified, the following defaults will be 
used: 


1050, 1403, 2740, 2741, (12,80) 

2780, TW33, TW35, CRLP 
2770 Video, Printer, Cards 

3653 (6,30) 

3650 User Program Terminal (3,80) 

3660 (1,40) 

2980 Printer (12,40) 

3270 displays and printers 
— default to DEFSCRN value. 

If this defaults, default is: 

Display model 1 — (12,40) 

Display model 2 — (24,80) # 

Printer — (12,80) 

3270 displays (3650HC attached) (23,80) 

Console (6,80) 

3767, 3770 Interactive, 3770/ (12,80) 

3790 Batch Data Interchange, 

3770, 3790 Full Function LUs 

LUTYPE4 (50,80) 


For a VTAM 3600, the PGESIZE specified is used if a BUS page 
build operation is attempted without specifying a logical 
device code (LDC) • A default device type of 3604 is assumed. 

If no PGESIZE is coded, the default values of (1,40) are taken 
for 3600. 

For 3770, LUTYPE4, or 3790 batch data interchange logical 
units, the PGESIZE specified is used if a BBS page build 
operation is reguested without specifying a logical device code 
(LDC). The default device type is the console printer. The 
default PGESIZE is (12,80). 

For 3270 printers, the hardware buffer size limits the amount 
of data which BBS may transmit. If the map or application 
program request specifies CTRL=L40, L64 or L80 or does not 
specify CTRL or PROPT, the product of lines and columns must 
not be greater than the buffer size. If the map or application 
program request specifies CTRL=H0NE0M, the maximum number of 
characters to be transmitted by BUS must not exceed the 
terminals buffer size. If the request specifies PROPT=NLEOB, 
the maximum number of characters to be transmitted by BBS must 
not be greater than the buffer size minus the number of lines 
to be printed. In either of the last two cases, lines and 
columns may be specified such that the product is greater than 
the buffer size. If more data is transmitted than the buffer 
can hold, the data will be wrapped around in the buffer and 
data will be lost. 
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PGESTAT= {AUTOPAGB| PAGE} 

specifies the type of paging activity that may occur at a given 
terminal. 

AUTOPAGE 

indicates that all requests to output data to the terminal 
from the page supervisor are to be paged automatically 
unless specified otherwise in the BMS requests. When 
autopaging, the page supervisor writes all pages in a page 
series to the terminal automatically. AUTOPAGE is the 
default parameter for the hard-copy terminals. Requests to 
write data directly to the terminal are not controlled by 
the PAGE or AUTOPAGE parameters because the page supervisor 
is not used for direct output. 


PAGE 

indicates that all reguests to output data to the terminal 
from the page supervisor are to be paged unless specified 
otherwise in the BMS requests. When paging, the first page 
from the paging supervisor is written to the terminal when 
the terminal becomes available. All subsequent pages in a 
page series are written to the terminal on request of the 
terminal operator through the use of paging commands. PAGE 
is the default for video terminals and for the processor 
console (CICS/DOS/VS only). 


PIPELN= {LAST |POOL} 

indicates that this TCTTE is to be used in a 3600 or 3650 
pipeline session. The default is PIPELN=LAST• 

LAST 

specifies that this TCTTE is the last of a pool of 3600 or 
3650 pipeline TCTTEs• This option is only applicable when 
SESTYPE=PIPELINE is specified. This option must be coded 
for each SESTYPE=PIPELINE if each session is to be a pool 
of one pipeline session. 


POOL 

specifies that this 3600 or 3650 pipeline TCTTE is pooled 
with other pipeline TCTTEs. This option is only applicable 
when SESTYPE=PIPELINE is coded and must be specified for 
each SESTYPE=PIPELINE (except the last in the pool) if the 
pipeline session is pooled. 


POLLPOS=number 

specifies, as a decimal integer, the position (relative to 1) 
of the polling characters associated with this terminal in the 
DFTRMLST supplied for the line. If GENPOLL=YES is specified 
(or implied by default) for the line entry, POLLPOS=1 is 
specified for each terminal entry associated with control unit 
1, P0LLP0S=2 is specified for each terminal entry associated 
with control unit 2, and so on. 
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PRINTTO= (label[ ,COPY]) 

specifies the primary 3270 printer to be used to support DFHTG 
TYPE=PRINT or a print request via a Program Access key from the 
operator, if the subject of the DFHTCT TYPE=TERMINAL 
instruction is a 3270 display without the printer—adapter 
feature, or a 3270 display attached to a 3274, 3276, or a 3790 
in 3270 compatibility mode without FBATURE=PTRADAPT. "label 11 
is the symbolic name which must be specified as the label on 
the DFHTCT TYPE=TERMINAL macro identifying the printer. See 
also the ALTPRT operand earlier in the description of this 
macro. PRINTTO and ALTPRT are available for VTAM 3270s and 
3270 compatibility mode logical units only. 

| The PRINTTO and ALTPRT operands must name a printer owned by 

| the same system as the subject of the DFHTCT TYPE=TERMINAL 

| macro instruction. 


| RELREQ= ({NOJYBS} , {N0|YES} ) 

| indicates whether CICS/VS is to release the logical unit, and 

| whether disconnect requests are to be honored. The default is 

| RELREQ=N0. 

(NO,...) 

indicates that CICS/VS is not to release the logical unit 
upon request by another VTAM application program. 


(YES,...) 

indicates that CICS/VS is to release the logical unit, if 
the logical unit is not currently part of a transaction. 


( . ..,NO) 

indicates that CICS/VS is not to honor a disconnect request 
for a VTAM device. NO is also the default. 

(. . .,YES) 

indicates that CICS/VS is to honor a disconnect reguest for 
a VTAM device, and issue a VTAM CLSDST macro instruction to 
terminate the VTAM session with that logical unit. 

In addition, CSSF GOODNIGHT from the terminal will cause 
disconnection if YES is specified. 

RMTNAME-name 

indicates the one— to four—character identifier of the terminal 
in the region where it is connected. The default identifier is 
the value of the TRMIDNT operand. This operand is ignored if 
the current region is the local region. 


| RUSIZE= {256 | size} 

specifies the maximum size of a request unit (RU) which can 
satisfy a VTAM RECEIVE request. The default value is 256 
bytes. 

The value specified in RUSIZE will be transmitted to the 
connected logical unit. This value may be adjusted slightly by 
CICS/VS according to the value specified, because the value 
must be transmitted in an architected form. Thus, the value 
may be rounded down by CICS/VS before being transmitted. 


SESTYPE=session—type 

I indicates the type of session that can be used for a VTAM or 

| TCAM SNA logical unit. The options are: 
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• PIPELN — for 3600 and 3650 pipeline logical units. 

• 3270 - for 3650 host conversational (3270) logical units. 

• 3653 — for 3560 host conversational (3653) logical units. 

• BSERPROG — for 3650 interpreter, 3650 host command 
processor (HCP), and 3770/3790 full function logical units. 

• BATCHDI — for 3770/3790 batch data interchange logical 
units. 

• 3277CM — for 3790 devices acting as 3270—compatible display 
logical units. 

• 3284CH or 3286CB — for 3790 devices acting as 3270- 
compatible printer logical units. 

• SCSPRT — for 3790 devices acting as SCS printer logical 
units. 

• INTL0 — for ITTY and Til model 33/35 devices acting as 
L0TYPB1 logical units in flip-flop mode. 

• CONTL0 — for ITTY and Til model 33/35 devices acting as 
L0TYPB1 logical units in contention mode. 

• SEND — for LU6 secondary logical unit for transaction to 
transaction communication. 

• RECEIVE — for LU6 primary logical unit for transaction to 
transaction communication. 

Refer to the TBHTYPB operand earlier in this macro for details 
of the combinations of TBHTYPE/SESTYPE specifications that can 
be used to generate support for logical units in CICS/VS. 


STN2980=number 

specifies the number for which the alternative station address 
and normal station address are to be generated for each 
terminal entry in the terminal control table corresponding to a 
2980 General Banking Terminal System. In response to a given 
STN2980 specification, an appropriate (hexadecimal) alternative 
station address and normal station address are generated by 
CICS/VS as follows: 


Number 

Normal 

Alternate 

0 

40 

F4 

1 

FI 

F5 

2 

F2 

F6 

3 

F3 

F7 

4 

F8 

34 

5 

5C 

24 

6 

61 

E5 

7 

B2 

£6 

8 

E3 

E7 

9 

£8 

24 


Example 1: For normal station address X'40', the user 
specifies STN2980=0 and an alternate station address of X'F4' 
is generated. 
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Example 2: For a 2972 model 11 with normal station address 
X *F8•, STN2980=4 should be specified, and an alternate station 
address of X*34* will be generated. 


SYSIDNT=name 

specifies the four-character alphanumeric name that must be 
specified for an explicitly generated TCTTE that is a member of 
a VTAM parallel session. The name must be the same as that 
used in the associated DFHTCT TYPE-SYSTEM macro. 


TA32980={0|value) 

specifies the number of tabs to the passbook area as defined by 
the user and physically (uniquely) set on the terminal. The 
default is TAB2980=0. 


TASKNO=number 

specifies the number of concurrent tasks allowed to run in a* 
pipeline session or in a pool of pipeline sessions and is only 
applicable when PIPELN=LAST is specified. 


TCTU AL=length 

specifies the length, in bytes (0 to 255), of the process 
control information field (PCI) for this terminal# The default 
is the TCTUAL value specified in the DFHTCT TYPE=LINE macro 
instruction, where applicable (that is, for BTAM and TCAM 
terminals only); if not specified there, the default is 
| TCTUAL=0. The TCT user area is initialized to zeros at system 

initialization. 


TI0AL = {value | (valuel, value2) } 

indicates the terminal input/output area length to be passed to 
a transaction for non—SNA devices, or when CHNASSY=NO is 
specified for logical units. 

value / 

If CHNASSY=NO, •value* specifies the minimum size of the" 

| terminal input/output area for a user—reguested READ , 

| operation that is to be passed to a transaction by the*' 

terminal control program. If the size of an input message 
exceeds the value specified in this operand, the size of 
the TIOA corresponds to the size of the massa ge.i If 
CHNASSY=YES, •value* is the normal chain size and also the 
maximum chain size, so specifying the TIOA size. 

| (valuel, value2) 

| If CHNASSY^NO is specified, *value2* is ignored and 

| •valuel• is •value*, above. If CHNASSY=YES, *value1* is the 

| normal chain size and *value2* is the maximum chain size. 

If CHNASSY=YES, a TIOA of normal chain size will initially 
be acquired by DFHZCP to satisfy a DFHTC TYPE=READ request. 

| If the normal chain size is not large enough, a larger TIOA 

| Will be acquired, and the maximum size of this TIOA will be 

j limited by *value2*. 

Note : The minimum size TIOA passed to a transaction which is 

running under control of 2260 compatibility is governed by the 
CMPT60L operand in DFHSG PROGRAM=TCP. For_"FASTER" compatible , 
terminals, the minimum TIOAL that can be specified is the 2260 
screen size. If a smaller value is specified, TIOAL will 
default to the 2260 screen size. 
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I 

I 


Note: If automatic transaction initiation is used, the 
minimum TIOAL that can be specified is one byte. 


TRANSID=transaction—identification—code 

specifies a one— to four—character transaction code whose use 
is dependent upon the terminal type for which it has been 
specified. 

If a TRANSID is not specified in the TCTTB, the TRANSID in a 
DFHPC RETURN request from the previous transaction will be 
used. Otherwise, the first one— to four— characters of the 
data passed in the TIOA are used as the transaction code. A 
delimiter is required for transaction identifications of less 
than four characters. 

For the 3735 Programmable Buffered Terminal, the TRANSID 
operand is used to specify the transaction code of the 
transaction that is to be initiated for a batch transmission 
initiated by the terminal operator. If an inquiry message is 
received from the 3735, the transaction code used consists of 
the first one— to four—characters following the inquiry header 
(NULL I NULL). 

The TRANSID operand must be specified for the 3735 Programmable 
Buffered Terminal if batched input processing is required. 

The TRANSID operand is optional for the 3740 Data Entry System. 
When provided, it specifies the transaction code of the 
transaction to be attached when input is received in batch mode 
unless: 

1. Input is received from the operator ID card reader. In 
this case CSSN is attached to perform sign-on. 

2. The transaction is automatically initiated. In this case, 
the transaction code specified in the initiation request is 
attached. 

3. The previous transaction specified TRANSID in the DFHPC 
RETURN reguest. In this case, the requested transaction is 
attached. 

If the terminal is in inquiry mode, the transaction code is 
that specified in 1. or 2. (above) or is taken from the first 1 
to 4 bytes of data. 

Note : If the 3740 does not have the expanded ID verification 
feature, the data must start in byte 1 of the second block. 

| Refer to "ID Verification" under "IBM 3740 Data Entry System" 

| in Chapter 5.7 of this manual. 

When using TCAM, TRANSID applies only to TCTLEs associated with 
the TCAM output queue. 

If this operand is coded for a 3790 Communication System, and 
multiple sessions are used to connect the same 3791, the same 
transaction code should be specified for all sessions. 

The TRANSID operand must be specified for 3614 logical units. 

It is optional for 3601 logical units. 

For all other terminals, the TRANSID operand is used to specify 
the transaction code of a transaction that is to be initiated 
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each time input is received from the terminal and there is no 
active task. 


TRMADDR={address|name} 

specifies the terminal address. 

address 

specifies the device address associated with a given 
terminal and is only required for BTAM devices. For most , 
non-switched lines, the hexadecimal addressing characters 
associated with the terminal must be specified. 


name 

specifies the label of the BTAM DFTRMLST macro instruction 
and is used for binary synchronous devices and switched 
lines. Use of the prefixes •TCT* i DFH 1 , or # NIB # in the 
label could cause assembly errors. 

Notes ; 

1. TRMADDR is not required for some BTAM devices such as the 
2741, local 2260, and local 3270. See the terminal control 
table configurator at the beginning of the description of 
the terminal control table. 

2. For TWX, TRMADDR is not required if ANSWRBK=TERMINAL is 
specified in the DFHTCT TYPE-LINE macro instruction. 

3. For a 3735, the BTAM DFTRMLST must be of the SWLST,AD type. 

4. For Teletypewriters (WTC only), specifies the label of a 
DFHTCT TYPE=TLXID macro instruction. 


TRMH0DL={number|character} 

specifies the model number of the terminal. If the device is 
one of the folio wing r this operand must be included in either* 
the DFHTCT TYPE=LINE or DFHTCT TYPE=TERf!INAL specification: 

• Component of the 1050 Data Communication System 

• 2740 Communication Terminal Model 2 

• Component of the 2980 General Banking Terminal System 

• Component of the 3270 Information Display System 

• 2260 Display Station 

• 2265 Display Station 


number 

0 

specifies an input component for the 1050 Data 
Communication System. Common polling character 0 (15) 
must be coded in the polling list (DFTRMLST). 

TRMMODL=0 is the default specification for a 1050 Data 
Communication System. 
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1 


specifies the 2980 Teller Station Model 1, and 3270 
(Model 1) displays and printers with a default screen 
or buffer size of 12x40 (480 bytes/characters) (for 
example, 3277 Model 1). TRMMODL=1 is the default for 
3270 (Model 1) printers and displays. 

2 

specifies the 2740 Communication Terminal Model 2, 2980 
Administrative Station Model 2, and 3270 displays and 
printers with a default screen or buffer size of 24x80 
(1920 bytes/characters) (for example, 3278 Model 4). 
TRMM0DL=2 is the default for the 3286 printer in 3270 
compatibility mode. 

4 

specifies the 2980 Teller Station Model 4. 

5 

specifies component polling of the keyboard for the 
1050 Data Communication System using nonswitched 
communication lines. Component selection character 5 
(0B) must be coded in the polling list (DFTRMLST) . 

6 

specifies component polling of reader 1 for the 1050 
Data Communication System using non-switched 
communication lines. Component selection character 6 

(OD) must be coded in the polling list (DFTRMLST). 

7 

specifies the component polling of reader 2 for the 
1050 Data Communication System using nonswitched 
communication lines. Component selection character 7 

(OE) must be coded in the polling list (DFTRMLST) . 

11 

specifies the 3275 Display Station Model 11. The 
CICS/VS support obtained will be identical to that for 
specifying TRMMODL=1 for 3275 Display Station Model 1. 

12 

specifies the 3275 Display Station Model 12. The 
CICS/VS support obtained will be identical to that for 
specifying TRMMODL=2 for, 3275 Display Station Model 2. 


character 

specifies the applicable screen format for a 2260/2265 
display station as follows: 


Specification 

Screen Format 

Device 

TRMM0DL=A 

6X40 

2260 

TRMMODL-B 

12X40 

2260 

TRMM0DL=C 

12X80 

2260 

TRMH0DL=D 

15X64 

2265 

TRMMODL^E 

12X80 

2265 

For example, TRMMODL=A specifies a 2260 
with a 6X40 screen format. 

Display Station 
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TRMPRTY={0|number} 

establishes the terminal priority. This decimal value (0 
through 255) is used in establishing the overall transaction 
processing priority. (Transaction processing priority is equal 
to the sum of the terminal priority, transaction priority, and 
operator priority, not to exceed 255.) The default is 
TRMPRTY=0. 


{TRANSACTION | (status, . . .) } 

specifies the types of activity that may occur at a given 
terminal. This terminal status is initially set in the TCTTE 
and is a combination of the processing status and the service 
status. The default is TRNSTAT=TRANSACTION. 


TRANSACTION 

indicates that a terminal with TRANSACTION status is used 
in the processing of transactions such as inquiries or 
order entries. A display station or a hard-copy terminal 
to which no messages are sent without a terminal request 
and through which transactions are entered is a TRANSACTION . 
terminal. 

Note ; This is the only processing status allowed for 3790 
inquiry logical units. 


INPUT 

indicates a terminal which can send messages to, but cannot 

receive messages from, CICS/VS. 

Notes: 

a. INPUT status is not valid for the 3270 and the 3790 
inquiry logical unit. 

t>. System messages may be routed to an input terminal 
under conditions such as invalid transaction 
identification and ATP batch count. This causes 
DFHTACP to be scheduled. To handle this situation, the 
user should code a DFHTEP to perform any user required 
action. See "User—Written Terminal Error Programs 11 in 
Chapter 4.2 of this manual. 


INTLOG 

| specifies, for ACF/VTAfi terminals only, a status which 

| allows internally generated session requests to create a 

| session. During CICS/VS execution, this status can only be 

| generated by a CENT command. 


NOINTLOG 

| specifies, for ACF/VTAM terminals only, a status which 

I prevents internally generated session requests from 

| actually creating a session. During CICS/VS execution, 

| this status can only be generated by a CENT command. 


TRMSTAT= 


I 
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IPL 


specifies that this is the logical terminal entry required 
for the IPL address of the System/7 with BSCA. To IPL a 
| System/7 on a binary synchronous line, a TCTTE must be 

generated exclusively for the IPL operation. This operand 
causes the logical terminal to be generated in RECEIVE 
status and sets the terminal model number to 11 9" to signify 
an IPL terminal. The status of an IPL terminal may not be 
changed except to in-service or out—of—service. 


•OUT OP SERVICE 1 

indicates a terminal which can neither receive messages nor 
transmit input. Such terminals are not polled by CICS/VS. 
The "OUT OF SERVICE* parameter can be used in combination 
| with any status setting. 

All terminals except the master terminal can be designated 
as *OUT OF SERVICE*. When appropriate, the terminals can be 
placed in service by the master terminal and polling will 
be resumed. 


RECEIVE 

indicates a terminal to which messages are sent but from 
which no input is allowed. An example of this type of 
terminal is one which is located in a remote location, such 
as a warehouse, and is unattended, but may receive 
messages. Automatic transaction initiation is implemented 
as for TRANSCEIVE, below. 

Note s RECEIVE should be specified for a System/7 with the 
Station Control feature. This allows polling to be 
suspended until the System/7 receives an IPL from the host, 
at which time the status is changed to TRANSCEIVE. If the 
System/7 receives a remote IPL, the master terminal must be 
used to change the terminal status to enable the System/7 
to transmit. 


TRANSCEIVE 

indicates that a terminal with TRANSCEIVE status is a 
TRANSACTION terminal to which messages are sent 
automatically by the user. The automatic transaction 
initiation, either by transient data control or interval 
control, sets a condition in an appropriate terminal 
control table terminal entry. If the terminal status is 
TRANSCEIVE and if there is no transaction at the terminal, 
terminal control initiates the user—defined task. This 
task is expected to send messages to the terminal. 

Note : If automatic transaction initiation is used, the 

minimum TIOAL that can be specified is one byte. 


VF=(NO|YES} 

indicates whether the vertical form feature is to be supported 
by the batch, batch data interchange, interactive, or LUTYPE4 
logical unit. VF=NO will override the VTAB=(tab,...) parameter 
in the DFHMSD macro instruction. The default is VF=NO. 
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CICS/OS/VS Only 


COMSLID-{ALL I number! 

indicates the level of support required when the processing 
unit console is to be used as a terminal under CICS/OS/VS. 

ALL 

indicates that a pool TCTTE (for all the consoles in the 
CICS/OS/VS system) will be generated with the user—options 
and default parameters provided. 

number 

specifies a number from 1 to 32, used to generate a 
specific TCTTE to indicate which individual console is to 
be used as a terminal. A pool TCTTE, with default values 
provided, is also generated. 

Notes ; 

1. If the CONSLID operand is not specified, a pool TCTTE with 
default parameter values is generated. 

2. Use of a console as a terminal is not supported for 
transaction routing. 


TELETYPEWRITER (WTC ONLY) STATION IDENTIFICATION — DFdTCT 
TYPE=TLXID 


The DFHTCT TYPE=TLXID macro instruction is used to define Teletypewriter 
(WTC only) station identifications. 


r - 

r 

-r- 



i 

label|DFHTCT 

i 

TYPE=TLXID 


i 

1 

i 

r TLXID=*ttame* 


i 

i_ 

1 

i_ 

i 

[,LASTID={H0|YES}] 



label 

the name field of the macro instruction is required and must be 
the same as the symbolic address specified in the TRHADDR 
parameter of the DFHTCT TYPE=TERHINAL macro instruction. 


TYPE=TLXID 

specifies one entry for the identification of Teletypewriters 
(WTC only) . 


I 

I 

I 

I 

I 


TLXID= , name r 

specifies the identification of a Teletypewriter (WTC only) 
subscriber as stored on a mechanical drum within the terminal. 

A more detailed explanation is given in OS/VS Basic 
Telecommunications Access Method and BTAM—ES Programmin g. An 
identification is a string of up to 20 characters. The first 
three characters are control characters and are not part of the 
name operand. Only the first 12 characters of the operand are 
used to form the name, which is a string of alphanumeric 
characters. Valid characters are: A—Z, 0—9, <, =, and blank. 
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I 

I 

I 


LASTID= fNQfYES) 

indicates the last identification. A value of YES should be 
coded in the last DFHTCT TYPE=TLXID macro in each region.The 
default is LASTID=NO. 


TELETYPES BITER (WTC ONLY) DISCONNECT MESSAGE — DFHTCT 
TYPE-TLXMSG (CICS/OS/VS ONLY) 


CICS/OS/VS does not support program disconnect for World Trade Teletype 
terminals. If a DFHTC TYPE=DISCONNECT request is issued, a message is 
written to the terminal, indicating that the terminal operator should 
manually disconnect. The message that is written can be specified in a 
DFHTCT TYPE=TLXMSG macro. 


r-1-1----- 1 

| name IDFHTCT I TYPE=TLXMSG | 

li I ,MESSAGE= i message l I 

i-1-1— -1 


name 

is required and must be the same as the name specified in the 
DISMSG parameter of DFHTCT TYPE=TERMINAL• 


TYPE=TLXMSG 

indicates that a DISCONNECT message is being defined. 


MESSAGED message * 

defines the message to be written in response to a DFHTC 
TYPE =DI SCO NNECT request. 


DIGITAL RESPONSE MESSAGES FOR 7770 AUDIO RESPONSE UNIT - 

DFHTCT TYPE=7770MSG (CICS/OS/VS ONLY) 


For CICS/VS to communicate with an audio terminal (for example, the 2721 
Portable Audio Terminal) , two digital response messages (an error 
message and a ready message) must be defined in the terminal control 
table for each line. This is accomplished by issuing the DFHTCT 
TYPE=7770MSG macro instruction, which must immediately precede the 
DFHTCT TYPE=FINAL macro instruction. To avoid confusion, these messages 
should be unique; that is, these messages should not also be defined in 
user—written application programs. 

The ready message is used by CICS/VS: 

• In response to a valid terminal identification being entered 
subsequent to line connection. 

| • When the sign—on sequence has been completed. 

• When a 7770 Audio Response Unit is connected to a line and no 
transaction is associated with the 7770. 

• In response to a READ request if the request sequence was not a 
WRITE, READ. 
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The error message is used by CICS/VS: 

• In response to an invalid terminal identification being entered 
subsequent to line connection. 

• When a valid terminal identification has been entered but: (1) the 
terminal has an "out of service" status, or (2) the terminal has an 
••in service" status but the terminal identification has already 
been entered on another line. 

• In response to an invalid transaction identification. 

• In response to an error during the signon/signoff seguence. 

• If the input message is too long. 

• If the transaction associated with the 7770 is abnormally 
terminated. 

• If a 32—second timeout occurs. 


| name IDFHTCT | TYPE=7770MSG, 

| | | MESSAGE=•message• 

i_i_i_ 


name 

is required and must be the same as the symbolic address 
specified in the RDYMSG or ERRMSG parameters of DFHTCT 
TYPE=LINE• 


TYPE=7770MSG 

indicates audio response messages. 


MESSAGE^ 1 message• 

defines digital response messages for the 7770 Audio Response 
Unit. These messages must be constructed in the form of 
hexadecimal constants, enclosed within single quotes, and may 
contain up to 48 hexadecimal digits (24 bytes). The first two 
digits must contain binary zeros (00) to represent a one-byte 
••silence" track address on the 7770; subsequent digits may be 
used to represent up to 23 additional one—byte 7770 track 
addresses. For further details, see Component Description 7770 
Audio Response Unit Model 3 • 

See Appendix B for an example of a typical digital response 
specification. 


END OF TERMINAL CONTROL TABLE - DFHTCT TYPE=FINAL 


The end of the terminal control table is indicated to the control system 
by the DFHTCT TYPE=FINAL macro instruction, which must be contained on 
the last control card for the terminal control table assembly before the 
assembler END statement. 


IDFHTCT | TYPE=FINAL 
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TYPE=FINAL 

indicates the end of the terminal control table. 


EXAMPLE 


| Figure 3.2—16 illustrates the coding which is required to create a 
CICS/VS terminal control table. The terminal network described 
includes: 

• One DASD sequential terminal. 

• Two 2740 Telecommunication terminals with the Station Control 
feature. 

• Two 1050 Data Communication terminals (dial-up)• 

Note : DFTRMLST macro definitions are required by BTAM devices. These 
entries should be coded immediately preceding the DFHTCT TYPE=LINE 
entries or immediately following DFHTCT TYPE=TERMINAL entries. 

To be applicable to CICS/OS/VS, or if converting from CICS/DOS/VS to 
CICS/0S/VS, the following changes must be made: 

• The DDNAME operand must be included unless the name specified in 
the DSCNAME operand is an acceptable default. 

• When used, the MODELST operand must be recoded as the MODE operand. 

• The MACRF operand must be included unless the default value for 
this operand is acceptable. 

If converting from CICS/DOS/VS to CICS/OS/VS, operands applicable 
only to CICS/DOS/VS need not be removed, because they are ignored by 
CICS/OS/VS. 

For other examples of terminal control table preparation, see 
Appendix B. 
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DFBTCT TYPE=INITIAL START OF TCT 

DFHTCT TYPE=SDSCI, SPECIFY DATA SET CONTROL * 

DEVADDR=SYS001 , INFORMATION * 

DEVICE=2314, * 

DSCNAME=DISKIN1 

DFHTCT TYPE=SDSCI, SPECIFY DATA SET CONTROL * 

DEVADDR=SYS006, INFORMATION * 

DEVICE=2314 , * 

DSCNAME=DISKOT1 

DFHTCT TYPE=LINE, DASD LINE BNTRY * 

ACCMETH=SEQOENTIAL, * 

TRMTYPE=DASD, * 

ISADSCN—DISKIN 1, * 

OSADSCN=DISKOT1, * 

INAREAL=80 

DFHTCT TYPE=TERMINAL, DASD TERMINAL ENTRY * 

TRMIDNT=SAMB, DASD SYMBOLIC NAME * 

TRMPRTY=11, * 

TRMSTAT=TRANSCEIVE 

DFHTCT TYPE=SDSCI, SPECIFY DATA SET CONTROL * 

CH=2703, INFORMATION * 

DEVICE=2740, * 

FEATORE=(STC,CHK), * 

LINELST 3 (027), * 

SWITCH=NO, * 

DSCNAME=DTF40MD 

PL2740L1 DFTRMLST OPBNLST,(46,45) POLL LIST TERMINAL 

DFHTCT TYPE=LINE, 2740 LINE ENTRY * 

ACCMETH=BTAM, * 

TRMTYPE=2740 f * 

TRMMODL=1, * 

DSCNAME=DTF40MD, * 

BTAMRLN=1, * 

LISTADR=PL2740L1, POLL LIST NAME * 

INAREAL=240, * 

FEATURE=(SCONTROL,CHECKING) 

DFHTCT TYPE=TERMINAL, 2740 TERMINAL ENTRY * 

TRMIDNT=T41L, 2740 SYMBOLIC NAME * 

TRMADDR=46, TERMINAL ADDRESS = L * 

TRMPRTY=127, * 

TRMSTAT=TRANSCEIVE 

DFHTCT TYPE=TERMINAL, 2740 TERMINAL ENTRY * 

TRMIDNT=T41K, 2740 SYMBOLIC NAME * 

TRMADDR=45, TERMINAL ADDRESS = K * 

TRMPRTY=128, * 

TRMSTAT=TRANSCEI7E, * 

LASTTRM=LINE LAST TERMINAL ON LINE 

DFHTCT TYPB=SDSCI, SPECIFY DATA SET CONTROL * 

CU=2703, INFORMATION * 

DEVICE=1050, * 

LINELST 3 (031) , * 

SWITCH=YES, * 

DSCNAME=DTF1050 


| Figure 3.2—16 (Part 1 of 2). Terminal Control Table — Example 
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IDL1050 DFTRMLST DIALST,0, (62 15,6415) 

DIL1050A DFTRMLST DIALST,7, 1239876 , (62 13 ) 

DIL1050B DFTRMLST DIALST,7,1239875, (6413) 

DFHTCT TYPE=LINE, 1050 LINE ENTRY * 

ACCMETH=BTAM, * 

TRMTYPE=1050, * 

DSCNAME=DTF1050, * 

INAREAL=8G, * 

BTAMRLN=1, * 

LISTADR=IDL1050, POLL LIST NAME * 

FEATURE^ (AUTOANSR,AUTOCALL), * 

POOLADR=T50POOL, * 

ANSWRBK=TERMINAL 

T50POOL DFHTCT TYPE=TERMINAL, 1050 TERMINAL ENTRY * 

TRMIDNT=T50A, * 

TRMADDR=DIL1050A, * 

TRMPRTY=203, * 

TRMSTAT=TRANSCEIVE 

DFHTCT TYPE=TERMINAL, 1050 TERMINAL ENTRY * 

TRMIDNT=T50B, * 

TRMADDR=DIL1050B, * 

TRMPRTY=204, * 

TRMSTAT=TR ANSCEIVE, * 


| LASTTRM=LINE LAST TERMINAL ON LINE 

DFHTCT TYPE=FINAL END OF TCT 

END 

| Figure 3.2—16 (Part 2 of 2). Terminal Control Table — Example 


TLT — TERMINAL LIST TABLE 


A terminal list table (TLT) generated by the DFHTLT macro instruction 
allows terminal and/or operator identifications to be grouped logically. 
A terminal list table: 

TRAN TLT SUFFIX 
ID SPECIFIED BY XX 

• Is required for use of a supervisory CEST ...SUPRID=xx 

terminal operation to define and 

limit the effective range of the 
operation. 

• May be used by a supervisory or CEST ...CLASID=xx 

master terminal operation to apply CEMT ...CLASID=xx 

a function to a predetermined group 

of terminals. (For a CEST function, 
this TLT must define a subset of 
the TLT specified by the SUPRID 
keyword.) 

• May be used singly or in combination CMSG ...R0UTE=.xx 

with other TLTs to provide predefined 

destinations for message switching. 

The module name of the terminal list table is DFHTLTxx where xx is a 
one— or two-character suffix to provide unique identification for each 
terminal list table used. There must be an entry in the processing 
program table (PPT) for each terminal list table to be used. 

The same TLT can be used for message switching and for supervisory or 
master terminal functions. For example, a TLT which defines the 
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terminals which are under control of a supervisory terminal, could also 
be used as a destination list for sending messages to those terminals. 

For some logical units, logical device code (LDC) mnemonics, which 
may be associated with each table entry, are used for message switching 
and are ignored for master and supervisory terminal operations. 

| In an intercommunication network all the terminals in a terminal list 
| table must be owned by the system on which the table is used. 


CONTROL SECTION — DFRTLT TYPE=INITIAL 


The entry point and the address of the start of the terminal list table 
being defined are established by the DFHTLT TYPE=INITIAL macro 
instruction. 

Note : A TLT must have a suffix to be used by the message switching 

transaction (CMSG) • 


| (DFHTLT | TYPE=INITIAL * 

| | | [,LDC=aa] 

| | | [ ,SUFFIX=xx] * 


| * See the first page of this chapter. 


LDC=aa 

specifies a two—character logical device code (LDC) mnemonic 
that is associated with every logical unit identification 
except for those for which an LDC mnemonic has been specified 
by *ldc. (See explanation of *ldc in the TRMIDNT operand of 
the DFHTLT TYPE=ENTRY macro instruction.) 


ENTRIES IN TERMINAL LIST TABLE — DFHTLT TYPE=ENTRY 


Entries are specified in the terminal list table as follows: 


i i ■ i 

| |DFHTLT | TYPE=ENTRY 

| | | , TRMIDNT= ([ termid—*1[ *ldc—1 J)[/opid—1 ] 

I | | [ , termid—2[ *ldc—2 ][/opid—2 ],...)] 

i-1-1- 


TYPE=ENTRY 

specifies that one or more entries are to be generated in this 
table. 


TRMIDNT= ([ termid-tC *ldc~1 ] }[/opid-1 ][ ,termid-2[ *ldc-2 ][/opid-2 J,...) ] 

specifies a list of start-stop and BSC terminal, and/or logical 
unit identifications, and/or operator identifications. A 
logical unit identification can be qualified by an LDC 
mnemonic. 
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termid 

indicates a one— to four—character start—stop or BSC 
terminal or logical unit identification. 

Note: A 3614 attached to a communications controller may 

be used in master or supervisory terminal operations but 
should not be used in message switching operations. (A 
3614 is not valid for a message destination.) 

Idc 

indicates a two—character LDC mnemonic, which must be 
preceded by an asterisk (*) and is only used following the 
••termid' 1 parameter. 


opid 

indicates a one— to three-character operator identification 
which must be preceded by a slash (/). 


Notes: 

1. Any terminal or operator identification specified should also be 
specified in the TRMIDNT operand of the DFHTCT macro instruction or 
the OPIDBUT operand of the DFHSNT macro instruction, except for 
outboard operator identifiers for the batch logical unit, which 
need not be defined to DFHSNT (see the BMSFEAT=OBOPID operand in 
DFHTCT TYPE=TERMINAL)• Any LDC mnemonic specified should also be 
specified in the LDC operand of the DFHTCT TYPE=LDC and DFHTCT 
TYPE=TERMINAL macro instructions. 

2. Supervisory and master terminal functions use all terminal and 
logical unit identifications included in the TLT, but ignore all 
references to LDC mnemonics and operator identifications. 


END OF TERMINAL LIST TABLE — DFHTLT TYPE=FINAL 


The macro instruction used to specify the end of a terminal list table 
is: 

f-1-r---- 1 

| (DFHTLT | TYPE=FINAL | 

i_i_i_i 


TYPE=FINAL 

indicates the end of the terminal list table. The assembler 
END statement must follow. 


EXAMPLE 

| Figure3.2—17 illustrates coding to create a terminal list table. 
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DFHTLT TYPE=INITIAL, * 

SUFFIX=AA 

DFHTLT TYPE=ENTRY, * 

TRMIDNT= (NYC,CHI,LA,WDC) 

DFHTLT TYPE=ENTRY, * 

TRMIDNT=SF 

DFHTLT TYPE=ENTRY, * 

TRHIDNT= (BSTN/OP1 , ATL/OP5 r /OP9 # DNVR) 

DFHTLT TYPE^ENTRY , * 

TRMIDNT=/OP6 

DFHTLT TYPE=FINAL 

END 

| Figure 3.2—17 (Part 1 of 2). Terminal List Table — Example 1 

DFHTLT TYPE =INITIAL f * 

SUFFIX=BB 

DFHTLT TYPE=ENTRY , * 

TRMIDNT= (NYC,T361*LP,T362*LP/0P1) 

DFHTLT TYPE=ENTRY, * 

TRMIDNT= (T363/OP2,T364/OP5,T365) 

DFHTLT TYPE=FINAL 

END 

| Figure 3.2—17 (Part 2 of 2). Terminal List Tanle — Example 2 


TST — TEMPORARY STORAGE TABLE 


The temporary storage table is a list of generic mnemonics used to 
identify temporary storage DATAIDs, which may be specified in either of 
two ways: 

• DFHTST TYPE=RECOVERY|ENTRY — each entry in the table specifies the 
leading characters of user-defined DATAIDs for which CICS/VS will 
provide protection during a logical unit of work by an application 
program , and automatic logging of the status of the data at task 
termination (or sync point). 

• DFHTST TYPE=REHOTE — access is provided to remote temporary 

| storage queues when CICS/VS intercommunication facilities are used. 

When a task accesses temporary storage data designated as 
| recoverable , the data is protected from modification by a concurrent 
task by enqueuing on the data identification (DATAID). The DATAID is 
not dequeued until the task terminates or issues a task sync point 
request to designate the end of a logical unit of work. At this time a 
log record is written to the system log data set to provide external 
| information sufficient to recover the data if the system subsequently 
| terminates abnormally. Resource level security checking of DATAIDs can 
| be obtained by specifying DFHTST TYPE=SECURITY. 


CONTROL SECTION — DFHTST TYPE=INITIAL 


The entry point and the beginning address for the temporary storage 
table being defined are established by the DFHTST TYPE=INITIAL macro 
instruction. 
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■I-1- 1 

| DFHTST| TYPE=INITIAL ♦ | 

| | [,StJFFIX=XX] * | 

| | {,TSAGB={0|number}] | 

v -1-ft 


* See the first page of this chapter. 


TSAGE={0|number} 

defines the ageing limit of temporary storage data used by the 
temporary storage recovery program (DFHTSRP) during emergency 
restart of CICS/VS. Data which is older than the specified 
limit will not be recovered. The value is specified in days 
with a maximum value of 512. A value of zero indicates that no 
data is to be purged on this basis. The default is zero. 


TEMPORARY STORAGE DATAIDS — DFHTST TYPE=RECOVERY/ENTR Y 


The generic mnemonics used to define temporary storage DATAIDs for which 
recovery processing is to be performed are specified by the DFHTST 
TYPE =RECO?ERY/ENTRY macro instruction. 

i-1-1-1 

| IDFHTST | TYPE={RECOVERY|ENTRY} | 

I | | [ ,DATAID= (character—string,character—string, .. •) ] | 

I_I_I_ _____1 


TYPE={RECOVERY|ENTRY} 

specifies that one or more entries are to be generated in this 
table. It identifies the temporary storage queue names that 
are recoverable. If, when CICS/VS intercommunication 
facilities are being used, a temporary storage queue name is 
such that it could be remote and recoverable, it is considered 
to be remote. Recoverability can only be specified in the 
system in which the queue is local. 


DATAID= (character—string, . •.) 

is used to specify a one— to eight-character alphameric 
mnemonic representing the leading characters of temporary 
storage DATAIDs for which recovery processing is to be 
performed. The parentheses are not required if only one 
character string is specified. 

Note: If a temporary storage table is generated with no 

entries, no recovery processing will be performed, even though 
the temporary storage program is generated with the recovery 
option. If an interval control PUT request is issued without 
the REQID parameter, CICS/VS will generate request 
identifications starting with the prefix H DF n . If recovery is 
reguired for these requests, the temporary storage table should 
be generated with the corresponding generic mnemonic. All 
DATAID prefixes used in restartable transactions (those with 
RBSTART=YES in DFHPCT TYPE=BNTRY) should be made recoverable 
(including the default "DF 11 prefix) • 

Only data on auxiliary storage can be made recoverable. Data 
put to main storage is not recoverable, regardless of the 
DATAID specified or the options generated in the temporary 
storage program. 
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REMOTE TEMPORARY STORAGE QUEUES — DPHTST TYPE=REMOTE 


The DFHTST TYPE=REMOTE macro instruction generates temporary storage 
| queue names, which relate to remote systems or regions when CICS/VS 
j intercommunication facilities are being used. 


| IDFHTST 1 TYPE=REMOTE 

| | | ,DATAID=character-string 

| | | ,SYSIDNT=name 

I I I [,RMTNAME=character—string] 

i-1-1_ 


i 

I 

1 

I 

I 


TYPE=REMOTE 

indicates that this temporary storage table entry defines a set 
of remote temporary storage queues. 


DATAID=character—string 

indicates a one— to eight—character alphanumeric mnemonic that 
represents the leading characters of the DATAID of a temporary 
| storage gueue that will reside on a remote system or region 

(identified by the name in the SYSIDNT operand). The DATAID 
| name is used by application programs in the system or region 

that is local to this TST. 


SYSIDNT=name 

| identifies the system or region in which the remote temporary 

storage queue resides. The name four—character alphanumeric 
name specified must be the same as that specified in SYSIDNT in 
the DFHTCT TYPE=SYSTEM macro. 


RMTNAME=character—string 

| specifies the 1— to 8—character prefix which will replace that 

specified in the DATAID operand when a reference to the 
| temporary storage queue is transmitted to a remote system or 

| region. This operand will default to the character string 

specified in the DATAID operand. The length of the character 
string specified in this operand must be the same as that in 
the DATAID operand. 


TEMPORARY STORAGE SECURITY CHECKING - DFHTST TYPE=SECURITY 


The DFHTST TYPE=SECURITY macro instruction is used to indicate that 
security checking is required for the temporary storage queues specified 
in the temporary storage table. 


i 1 i-~i- - 

| IDFHTST | TYPE=SECURITY 

I I j [ ,DATAID=character—string] 

I | I [ ,RSL = {0| number} ] 

i_»_i_ 


T 

I 

I 

I 

4 


TYPE=SECURITY 

indicates that this temporary storage table entry defines a set 
of temporary storage queues which require security checking. 
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DATAID=character—string 

specifies a 1— to 8— character alphanumeric mnemonic 
representing the leading characters of the temporary storage 
DATAID for which security checking is required. 


RSL = {0|number} 

indicates the security level, in the range 1 to 24 to be 
associated with this resource. The default is RSL=0. 

If it is required that security checking be performed on the 
entries, then a separate DFHTST TYPE=SECURITY macro must be 
coded as well as a DFHTST TYPE=ENTRY or TYPE=REMOTE. If the 
RSL operand is specified on a DFHTST TYPE=ENTRY or TYPE=REMOTE 
macro, then an MNOTE will be generated informing the use of 
this restriction. 


END OF TEMPORARY STORAGE TABLE — DFHTST TYPE=FINAL 


The end of the temporary storage table is indicated to the control 
system by the DFHTST TYPE=FINAL macro instruction which is the last 
statement in the assembly of the temporary storage table before the 
assembler END statement. This macro instruction creates a dummy entry 
to signal the table end. 

^ i i i 

| IDFHTST | TYPE=FINAL | 

i_i_a-1 


TYPE=FINAL 

indicates the end of the temporary storage table. 


EXAMPLE 

I Figure 3.2—18 illustrates an example of the coding necessary to create a 


C ICS/VS 

temporary storage table. 




DFHTST TYPE=INITIAL, 

LIST OF DATAID 

4c 


SUFFIX=RC 

MNEMONICS TO BE 


* 


RECOVERABLE 



DFHTST TYPE=RECOVERY, 

DATAIDS BEGINNING 

4c 


DATAID=Y 

WITH , Y I ARE 


4c 


RECOVERABLE 



DFHTST TYPE=RECOVERY, 

DATAIDS BEGINNING 

4c 


DATAID= (EY,ERY) 

WITH 'EY* OR •ERY* ARE 


4c 


RECOVERABLE 



DFHTST TYPE=RECOVERY, 

DATAID 1 RECOVERY * 

4c 


DATAID=RECOVERY 

IS RECOVERABLE 



DFHTST TYPE=REMOTB 

DATAIDS BEGINNING WITH 

4c 

4c 

DATAID=R 

*R* ARE RECOVERABLE 



DFHTST TYPE=REMOTE, 

REMOTE DATAID 

4c 


DATAID=YR 

NOT RECOVERABLE (ALTHOUGH 


* 


BEGINS WITH *Y*) UNLESS 


4c 


SPECIFIED AS RECOVERABLE 


4c 


IN THE REMOTE SYSTEM 



DFHTST TYPE=FINAL 




END 

| Figure 3.2—18. Temporary Storage Table — Example 
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XLT — TRANSACTION LIST TABLE 


The transaction list table, generated by the DFHXLT macro instruction, 

| is a list of logically related transaction identifications. One use of 
a transaction list table is to define a list of transaction 
identifications which can be initiated from terminals during the first 
guiesce stage of system termination. The suffix of the table to be used 
is specified at system initialization and can be changed during system 
| termination. Another use is to define a group of transaction 

identifications to be disabled or enabled through the master terminal. 
The suffix of the table to be used in this case is provided through the 
master terminal at execution time. 

Each transaction list table must have an entry in the processing 
program table (PPT). 

| Figure 3.2—19 illustrates the coding to create a transaction list 
| table. 


CONTROL SECTION — DFHXLT TYPE=IHITIAL 


The entry point and start address of the transaction list table being 
defined are established by the DFHXLT TYPE=INITIAL macro instruction. 


* I 

* I 


I I I- 

|| |DFHXLT | TYPE=INITIAL 

I I I I [ f SUFFIX=xx] 

i-«-1- 


| * See the first page of this chapter. 


ENTRIES IN TRANSACTION LIST TABLE — DFHXLT TYPE=ENTRY 


Entries are specified in the transaction list table as follows: 


| |DFHXLT | TYPE=ENTRY | 

| | | # TASKREQ=(kkkJc[ # kkklt] r ...) | 

| j | , TRA NSID= (xxxx[ , xxxx ],...) | 

i-1-1_i 


TYPE=ENTRY 

specifies that one or more entries are to be generated in this 
table. 
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TASKREQ-(kkkk[,kkkk ],...) 

represents one of the following 3270 special keys which can be 
used to initiate a task: PA 1 through PA3, and PP1 through 
PF24. LPA (light pen attention) indicates that a transaction 
is to be initiated when a light pan detectable field is 
selected. OPID (operator identification card reader) indicates 
that a transaction will be initiated when the appropriate 
| operator f s identity badge has been read in. TASKREQ=MSRE 

| indicates that transactions will be initiated when the 10/63 

| character magnetic stripe reader is used. 

An entry in the PCT is required for each TASKREQ generated. 


TRANSID=(xxxx[,xxxx ],...) 

represents a one— to four—character transaction code. An entry 
in the PCT is required for each TRANSID used. 

Note: TASKREQ and TRANSID are mutually exclusive parameters. 


END OP TRANSACTION LIST TABLE — DPHXLT TYPE=FINAL 


The macro instruction used to specify the end of the transaction list 
table is: 

i-1- r~ ---1 

| |DPHXLT | TYPE=FINAL | 

i-1-1---1 

TYPE=FINAL 

indicates the end of the transaction list table. The assembler 
END statement must follow. 


EXAMPLE 


DFHXLT TYPE=INITIAL, 

StJFFIX=IN 

* 

♦ 

DPHXLT TYPE=ENTRY,TASKREQ=PF5 

♦ 

* 

♦ 

DPHXLT TYPE=ENTRY,TRANSID= (CSMT,CSSF) 

DPHXLT TYPE=FINAL 

END 


LIST OF TRANSACTIONS WHICH 
WILL BE ACCEPTED DURING THE 
FIRST QUIESCE PHASE OP 
SYSTEM TERMINATION 
(TASKREQ MUST ALSO BE 
ENTERED IN THE PCT AND AN 
ENTRY FOR THE XLT MUST 
ALSO BE MADE IN THE PPT) 


DPHXLT TYPE=INITIAL, 

SUPFIX=G1 

DPHXLT TYPE=ENTRY,TRANSID= (TSSA,TSRA) 
DPHXLT TYPE=ENTRY,TRANSID=(TDSA,TDRA) 
DPHXLT TYPE=ENTRY r TRANSID=ICSA 
DPHXLT TYPE=FINAL 
END 


LIST OF LOGICALLY RELATED 
TRANSIDS TO BE ENABLED OR 
DISABLED BY MASTER TERMINAL 
(TRANSIDS MUST ALSO BE 
ENTERED IN THE PCT) 


| Figure 3.2—19. Transaction List Table — Example 
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Chapter 3.3. Table Preparation for Recovery /Restart 
Support 


The generatioa of recovery/restart support ia CICS/VS is discussed below 
under the following headings: 

• Telecommunications errors 

• Program checks in application programs 

• Operating system abends 

• CICS/VS warm restart 

• CICS/VS dynamic transaction backout and transaction restart 

• CICS/VS emergency restart 

The CICS/VS System/Application Design Guide discusses the various 
functions of recovery/restart in detail. Chapter 2.3 of this manual 
describes the actions necessary in the system generation process to take 
advantage of these facilities. The specifications that need to be made 
during the preparation of CICS/VS system tables are described below. 


TELECOMMUNICATIONS ERRORS 


The program control taole (PCT) must contain an entry for the VTAM 
logical unit node abnormal condition transaction (pSNE) if the 
installation has terminals connected to CICS/VS via VTAM, and/or the 
terminal abnormal condition program transaction (CSTE) if the 
installation has non—VTAM terminals. Refer to Appendix A for details of 
these transactions. 


The processing program table (PPT) must contain entries for the 
following programs if the access methods indicated are used in the 
system. The appropriate DFHPPT TTPE=GROUP,FN=function macros may be 
used to provide these entries: 








DFHTACP 

DFHTEP 

DFHTEPT 

DFHZNAC 


Terminal abnormal condition program (BTAM) 

Terminal error program (BTAM) 

Terminal error program table (only required if the CICS/VS 
sample terminal error program is used) (BTAM) 

Node abnormal condition program (VTAM) 


• DFHZNEP Node error program (VTAM) 


If re—presentation of in—doubt committed output messages is required 
after the recovery of a failed VTAM session, terminal recovery support 
should be specified as under "CICS/VS Emergency Restart" below. 
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PROGRAM CHECKS IN APPLICATION PROGRAMS 


No table generation actions are required in this situation. If the 
installation wishes to have a program error program (DFHPEP) invoked in 
the event of a transaction abend, an entry for DFHPEP should be made in 
the PPT. 


OPERATING SYSTEM ABENDS 


A system recovery table (SET) must be generated to indicate which 
specific operating system abends are to be handled. 


When generating the system initialization table (DFHSIT) the following 
specifications can be made: 

• The abnormal keypoint operand (ABKPOPT) may oe specified. This 
operand would normally be specified as NO, because as a general 
rule a warm restart may not be possible after abnormal termination. 

• Each of the warm restartable resources must be specified as such. 

• The KPP operand must indicate the suffix to be used for the 
keypoint program. 


CICS/V S DYNAMIC TRANSACTION BACKOUT AND TRANSACTION RESTART 


The following provisions should be made when generating dynamic 
transaction backout support: 

• The DBP and DBUFSZ must be specified in the system initialization 
table (DFHSIT). 

• An entry for the appropriate dynamic transaction backout program 
(DFHDBPxx) must be made in the processing program table either 
through DFHPPT TYPE=ENTRY,PROGRAM=DFHDBP or through the DFHPPT 
TYPE =GROUP,FN=BACKOUT macro. The suffix on this entry must 
correspond with the suffix specified in the DBP=xx operand in 
DFHSIT. 

• DTB=YES (or DTB= (YES,NO) for an intersystem communication session) 
should be specified in the program control table (DFHPCT) for each 
transaction code for which dynamic transaction backout is to be 
performed, and for the •■mirror" transaction (CSMI) for recoverable 
resources in a remote system. The overheads involved in specifying 
DTB=YES are not significant when recoverable resources are not 
changed. Thus, the user may be well advised to specify DTB=YES for 
all PCT entries, including those for tasks that do not modify 
protected resources. 

• The transaction restart facility (provided by the RESTART=YES 
parameter in the DFHPCT TYPE=BNTRY macro) may be used in 
conjunction with dynamic transaction backout. 
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• Recoverable destinations should be specified by tne DESTRCV=LG 
operand of the destination control table (DFHDCT TYPE=INTRA). 

• Recoverable files should be specified by the LOG=YES operand of the 
file control table (DFHFCT TYPE=DATASET). For files that use 
dynamic transaction backout support, the file control table entry 
must also include the reverse function to that specified in the 
SERVREQ operand. Thus, for example, if SERVREQ=NEWREC is specified 
for a file, SERVREQ=DELETE must also be specified. 

• The OPTGRP parameters, and relationships of individual PCT entries 
to the specific OPTGRP in support of VTAM message recovery, should 
be defined in the program control table (DFHPCT)• 

• A temporary storage table suffix should be specified in the TST 
operand when generating the system initialization table (DFHSIT). 


CICS/VS EMERGENCY RESTART 


The following specifications should be made when generating CICS/VS 
emergency restart support: 

• A non—zero activity keypoint frequency must be specified in the 
AKPFREQ operand of the system initialization table (DFHSIT). 

• The device type (TAPE or DISK) of the system log must be specified 
in the JCT operand of the system initialization table. 

• The TST and KPP operands of the system initialization table must 
have suffixes specified. 

• Entries for the CSKP, CSLG and CSRS transactions should be included 
in the program control table, either through a DFHPCT 
TYPE=ENTRY,TRANSID=xxxx macro or through the DFHPCT TYPE=GROUP, 
FN=AKP, RESPLOG, and RESEND macros respectively. The last two 
transactions are only required if resynchronization of logical 
units is to be supported. 

• The type of recovery required should be specified in the DESTRCV 
operand of the DCT for each DCT entry. 

• Recoverable files should be indicated by the LOG=YES operand of the 
file control table (DFHFCT). 

• The journal control table (DFHJCT) should include the 
JFILEID=SYSTEM and JOUROPT= (CRUCIAL,INPUT) specifications. 

• The OPTGRP parameters, and relationships of individual PCT entries 
to the specific option groups in support of VTAM message recovery, 
should be defined in the program control table (DFHPCT). 

• Entries for DFHAKP, DFHRUP, DFHTBP, DFHTDRP, DFHTSRP, DFHUAKP, 
DFHZRLG, and DFHZRSP must be made in the processing program table 
either through a DFHPPT TYPE=£NTRY,PROGRAM=name macro or through 
the appropriate DFHPPT TYPE=GROUP,FN=function macro. 

• A temporary storage table (DFHTST) should be generated to specify 
the recoverable temporary storage DATAIDs. 
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Chapter 3.4. Table Preparation for DL/I Facilities 


This chapter provides details on how to include DL/I facilities in a 
CICS/DOS/VS or a CICS/OS/VS system. 


D L/I WITH CICS/DOS/VS 


The specification of system table macros for DL/I support in CICS/DOS/VS 
requires the following steps: 

| • Generation of the DL/I DOS/VS Data Base system as described in the 

DL/I DOS/VS Otilities and Guide for the System Programmer manual. 

| • Generation of the CICS/DOS/VS system as described in Part 2 of this 

manual. 

• The DL/I DOS/VS application control table (ACT) must be generated — 
(refer to the DL/I DOS/VS Utilities and Guide for the Sys tem 
Programmer manual.) 

• An entry must be included in the file control table (FCT) for each 

| DBD corresponding to a physical data base. The name of the DATASET 

| parameter in the FCT and the NAME parameter in the DBD must be 

identical. 

| • An entry must be made in the processing program table (PPT) for the 

I DL/I language definition table (DLZHLPI) if the execution 

| diagnostic facility (EDF) is to be used with application programs 

| containing EXEC DLI commands. DLZHLPI is a module provided with 

| DL/I DOS/VS. 


D L/I WITH CICS/OS/VS 


The specification of DL/I support in CICS/OS/VS requires the following 
steps: 

1. Generate the IMS/VS Data Base system (see the IMS/VS Version 1 
System Programming Reference Manual ), including the program 
specification blocks (PSBs) and the data base descriptions (DBDs) . 

2. Generate the CICS/OS/VS system as described in Part 2 of this 
manual. 

3. Generate the required IMS/VS control blocks to define the IMS/VS 
system to CICS/OS/VS. 


Chapter 3.4. Table Preparation for DL/I Facilities 


345 



I 

I 


a. Ensure that an entry is included in the file control table 
(FCT) for each DBD corresponding to each physical, logical, and 
index data base. The name of the DATASET parameter in the PCT 
must be the same as that in the NAME parameter in the DBD. 
Entries are also reguired in the file control table for data 
bases that are to be accessed from sharing batch regions 
through CICS/OS/VS. Physical, logical, and index data sets 
must be represented in DFHFCT and in DFHDLDBD if the CICS/VS 
master terminal facilities are to be used to close data bases. 

b. Define the following special requirements needed to generate 
DL/I program specification blocks (PSBs) when using DL/I under 
CICS/OS/VS. 

(1) A special initialization PSB is used by CICS/VS—DL/I 
initialization to bring the proper DL/I modules into 
storage. This PSB, called the "initialization PSB", is not 
used by any transaction. Program communication blocks 
(PCBs) are defined within the PSB to indicate what type of 
CALLS and data bases DL/I will be called upon to service. 
The following rules apply: 

— Define one data base PCB (TYPE=DB) for each of the 
following access methods to be used: HSAM or HDAM. 

— Define one data base PCB for each of the following 

access methods to be used with VSAM: HISAM, HIDAM, or 
SHISAM. 

| — Define two data base PCBs for the same data set for 

| VSAM with HDAM. 

— Define two data base PCBs for the same data base for 
each of the following access methods to be used with 
ISAM: HISAM or HIDAM. These PCBs will be referred to 

as a PCB pair. Their specification causes BISAM rather 
than QISAM to be used. 

— Within each PCB, define PROCOPT (processing options) to 
include all processing options to be performed against 
all the data bases using that access method. That is, 
if one HDAM data base is to be accessed via PROCOPT-GB 
and another via PROCOPT=GRP, the combined PROCOPT to be 
specified is PROCOPT=GRPE. 

— For each PCB being defined, provide one 5BNSEG 

statement. For the PCB pairs required for HISAM or 
HIDAM with ISAM (see above), the SENSEG statements must 
refer to the same segment type. If QISAM is used in 
addition to BSAM, an additional SENSEG statement in one 
PCB of the PCB pair must be provided. 

— In the PCB statement, specify KEYLEN to be the length 
of the key field defined in the SENSEG statement. 

— The last statement preceding the END statement in the 
assembly should be written: 


PSBGEN LANG=ASSEM,PSBNAME=psbname 

If DL1=YES is specified during CICS/VS system 
initialization, the PSB used is called CICSPSB, unless 
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overridden in the system initialization table or by the 
execution time PSB parameter. 

If the CICS/OS/VS system is to handle requests for remote 
data bases only, no data base processing will occur on the 
local system. In this case, no initialization PSB need be 
specified, but the system programmer must ensure that all 
the PSBs specified in the PDIR (see the DPHDLPSB macro 
below) are for remote PSBs. A DDIB (see the DFHDLDBD macro 
later in this chapter) without any DFHDLDBD TYPB=ENTRY 
statements must be generated. 

In the event of a program isolation deadlock during a 
shared data base session, two types of transactions will be 
involved: a mirror transaction, and a transaction of 

another type. If two transactions of the same type become 
deadlocked, the system programmer may choose which one to 
abnormally terminate. If a mirror transaction and a 
different type of transaction become deadlocked, the non- 
mirror transaction must be abnormally terminated. 

When program isolation scheduling is used, there is no need 
for the user to create duplicate PSBs. More than one 
transaction can use the same update PSB. 

If an application program wishes to access a PSB that 
resides on another CICS/OS/VS system, there must be an 
entry for the PSB in the PDIR. The entry must specify the 
SYSIDNT and MXSSASZ (and, optionally, RMTNAME) operands. 

(2) If an application programmer does not name a PSB in the 
DL/I CALL, the PSB used has the name of the program whose 
name is in the program control table (PCT) entry for this 
transaction. Therefore, for all transactions with DL/I 
CALLs where the PSB name is not specified, there must be a 
PSB generated with the same name as the program name in the 
PCT entry for the transaction. 

(3) If an application programmer names a PSB in the DL/I CALL, 
there must be a PSB generated with the name used in that 
CALL. 

(4) If DL/I shared data base support is required, the following 
system table macros and operands must be specified: 


I 

I 


• DFHTCT TYPE=IRCBCH,SESNtJMB=nuaber 

• DFHSIT,IRCSTRT=YES or CEMT SET IRC OPEN from the master 
terminal 

• DFHSIT,ISC=YES or xx, or as an override 

• DFHSIT,EXEC=YES (or default) 

• DFHPCT TYPE=GROUP,FN=ISC 

• DFHPPT TYPE=GROUP,FN=ISC. 


The CICS/OS/VS—DL/I interface uses the pre-built blocks feature of 
IMS/VS. After all program specification blocks (PSBs) and data base 
descriptions (DBDs) have been generated, the user must then generate 
application control blocks (ACBs) in the IMS/VS ACB Library for all PSBs 
| and DBDs (and data management blocks (DMBs) produced when the ACB is 
| generated) that are to be used (including those that are to be accessed 
from sharing batch regions through CICS/OS/VS). The instructions for 
this generation are included in the IMS/VS Utilities Reference Manual . 
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I Note : The PSBs and DMBs generated during ACB generation must be 
| smaller than 64K bytes each, otherwise they cannot be handled by 
| CICS/OS/VS. 

A PSB directory (PDIR) list and a DMB directory (DDIR) list must be 
built for the CICS/VS—DL/I interface. Bach of these lists is built by a 
separate assembly and link edit. 


GENERATE PDIR - DPHDLPSB (CICS/OS/VS ONLY) 


A PSB directory list (PDIR) is generated by an assembly of DFHDLPSB 
macros as follows: 


i-1- —i-1 

| | |DFHDLPSB| TYPE=INITIAL * | 

I | | [ ,(DLI|DL1}=y.y.y] | 

I I I I [ ,SUFFIX=XX] * | 

i-1_i___i 


| * See the first page of this chapter. 


{DLI | DL1} =y • y • y 

indicates the IMS/VS level in the form: Version. Release. 

| Modification level. The levels of IMS/VS supported are 1.1.5 

| and 1.1.6. 



i -- r 

IDFHDLPSBI 

TYPE=ENTRY 




,PSB=psbname 



i i 

[ ,HXSSASZ=value] 



t i 

[,RMTNAME=aame] 



i t 

1_L. 

[ ,SYSIDNT=name] 

_1 


TYPE=ENTRY 

specifies that one or more entries are to be generated in this 
list. The maximum number of entries that can be included in 
the list is 2000. 


PSB=psbname 

specifies the name of the program specification block (PSB). 
The PSBs required by IMS/VS batch application programs that 
participate in a shared data base session must be represented 
in this macro. 


MXSSASZ^value 

specifies the maximum size of a segment search argument to be 
used for this PSB. This operand is only required if the 
SYSIDNT operand is specified. 

| Note : An excessively large value for MXSSASZ will cause 

| considerable increase in performance cost, and may lead to a 

| data stream being shipped which is too large for the connected 

| CICS/VS system. 
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RHTNAtlE=name 

indicates the name by which the PSB is known in the remote 
| system or region and need only be specified when the SYSIDNT 

operand is used. The default is the psbname specified in the 
PSB operand. If the original application program that makes 
| the request against this PSB is not on this system or region, 

or is a batch program using shared data base support, the PSB 
must be local to this system. Chaining of reguests from one 
| system or region to another is not allowed. 


SISIDNT=name 

indicates the four—character alphanumeric name of the remote 
| system or region for which the PSB is applicable when CICS/VS 

j intercommunication facilities are used. The name specified 

| must be the same as that in the SYSIDNT operand in the TCT. 

| The local system or region is assumed if this operand is 

omitted. 


r-•-1-» 

| |DFHDLPSB| TYPE=FINAL | 

i_I_i-» 


TYPE=FINAL 

indicates the end of the PSB directory list. An END DFSID1B0 
statement must also be specified. 


GENERATE DDIR — DFHDLDBD (CICS/OS/VS ONLY) 

A DMB directory list (DDIR) is generated by an assembly of the following 
DFHDLDBD macros: 


i ". — 1 .r i . “ . _| 1 . 

| | |DFHDLDBD| TYPE=INITIAL * 

| | | [ 9 {DLI|DL1}=y.y.y] 

|| | | [ ,SUFFIX=xx] * 

L--1-1-... ------- -— 


| * See the first page of Chapter 3.2. 


{dli | DLI} =y.y.y 

indicates the IMS/VS level in the form; Version. Release. 

| Modification level. The levels of IMS/VS supported are 1.1.5 

| and 1.1.6. 


| |DFHDLDBD| TYPE=ENTRY 

| I | ,DBD=dbdname 

I-L-1- 


1 


I 

J 


TYPE=BNTRY 

specifies that one or more entries are to be generated in the 
list. The maximum number of entries that can be included in 
the list is 5000. 
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I 

I 

I 


DBD=dbdname 

specifies the name of the data base description block (DBD). 

In a CICS/YS intercommunication environment only those DBDs 
that reside in the given CICS/OS/VS system or region need 
appear in the DDIR. Thus, if an application program in the 
| local system or region makes a request for a data base on a 

remote system, the corresponding DBD(s) need not appear in the 
| DDIR for the local system or region. Any data bases that are 

to be accessed by sharing regions should be included in the 
DDIR . 

I Note: If there are no local data bases on the CICS/OS/VS system or 
| region (that is, if the DL/I application programs make requests for 
remote data bases only), a DDIR (with no TYPE=ENTRY statements) must 
still be generated. 



|DFHDLDBD| TYPE=FINAL 

i_i___ 



TYPE=FINAL 

indicates the end of the DMB directory list. An END DFSIDMDO 
statement must also be specified. 


RESTRICTIONS ON THE IMS/VS BATCH APPLICATION PROGRAMMER 


The IMS/VS batch application programmer must be aware of certain 
restrictions that exist when DL/I batch application programs run in a 
| shared data base environment under CICS/OS/VS. These restrictions, 
j which apply to batch application programs and utilities, are as follows. 

Three types of DL/I requests may be issued by a batch application 
program: 

• All data base access calls (GUGN#)f, GNPJf, GHUJf, GHNP, GHNJtf, 

ISRT, DLET, and REPL) 

• System service calls — (CHKP and LOG only) 

• ROLLBACK call, which results in the following: 

— Message DFH3731 will be issued 

— Any DL/I updates since the last CHKP call (or since the start 
of the jobstep) will be backed out (assuming that dynamic 
transaction backout is active in the CICS/VS region) 

— The batch region will be abnormally terminated with a user 
abend code of 3731 

Note : If the application program issues a CHKP call and the CICS/VS 
shared data base session is in quiesce (that is, if the master terminal 
| has issued CEMT PERFORM SHUTDOWN or CEMT SET IRC CLOSE, the application 
program will terminate immediately after the CHKP call with a user abend 
code of 3707 or 3708. 

The first byte of a log record used in a LOG call must be equal to or 
greater than X*k0*, as in IMS/VS DB. An additional restriction when 
using shared data base is that the second byte of the record must be 
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X^O*. If these restrictions are not observed, a PCB status code of GL 
is returned, and the record is not logged. 

IMS/VS application programs that use GSAM PCBs or PCBs with PROCOPT=L 
or LS (that is, those used for loading a data base) are not supported in 
the batch shared data base environment. 

In all other respects, IMS/VS batch application programs run 
satisfactorily in a shared data base session without being recompiled or 
re—linkedited. IMS/360 application programs, however, are not 

supported. The IMS/VS batch application programmer should be aware, 
however, that resources used by batch programs must be released as soon 
as possible (by means of CHRP calls) so that online programs are not 
delayed by waiting for these resources. 

Application programs that are used in a shared data base session may 
issue SPIE and STAB macros. When a DL/I request is made by the 
application program, the batch region controller modules will issue 
their own SPIE macro for the duration of the request, and will then 
restore the user's SPIE, if any. 

There are certain abnormal terminations from which recovery cannot be 
attempted. Indeed, in these situations, the batch region controller 
will have broken the link between the batch regions and CICS/VS. 
Therefore, the user application program should not use a STAE (or BSTAE) 
exit unless the exit continues the abend. The PL/I STAE option should 
| not be used because the PL/I (E)STAE exit does not continue the abend. 

If the user's application program completes by returning to the batch 
region controller, the controller will assume that the application 
program has completed successfully and may indicate to CICS/VS that any 
DL/I data base updates should be committed rather than backed out. If 
the application program wishes to indicate that the updates should be 
backed out, it should issue an OS/VS ABEND macro or a DL/I ROLLBACK 
call. If a program check occurs and the user has no SPIE exit, an abend 
will be forced. Note that the PL/I SPIE exit will return to the batch 
region controller without issuing an abend. For this reason, the PL/I 
SPIE option should not be used. 

For information on all JCL changes that must be made to support the 
batch jobstream in CICS/0S/V5, refer to the C ICS/VS System Programm er's 
Guide (OS/VS) . 
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Chapter 3.5. CICS/VS Intercommunication Facilities 


This chapter provides details on how to include intercommunication 
facilities in a CICS/DOS/VS or a CICS/OS/VS system. 


TERMS USE D 


The term "CICS/VS intercommunication facilities” embraces the 
intersystem communication facility that was introduced in CICS/VS 
Version 1, Release 4, and enhancements to this facility that are 
provided in CICS/VS Version 1, Release 5. The components of the CICS/VS 
intercommunication facilities are: 

1. CICS/VS function request shipping 

— where an application program makes a request to use a resource 
(for example, a file, a DL/I data base, a transient data 
destination, a temporary storage queue, or a transaction) that 
is owned by another CICS/VS system or region. 

2. CICS/VS transaction routing 

— where a terminal owned by one CICS/VS system or region runs a 
transaction that resides in another CICS/VS system or region. 

3. CICS/VS distributed transaction processing 

— where a transaction in one system communicates synchronously 
with a transaction that is running in another system. 


METHODS OF COMMUNICATION 


The methods by which communication takes place are: 

1. An SNA access method (for example, ACF/VTAM) when communication is 
across a number of CICS/VS systems that are in different processing 
units or domains. This is known as a "domain—remote” connection. 

2. The CICS/VS multiregion operation (MRO) facility, which should be 
used when CICS/VS is running in different regions or partitions 
within the same domain. This is said to be a "region-remote” 
connection. MRO uses an interregion SVC to pass information 
between the regions on OS/VS, and interregion controller code 
running in key 0 on VSE. 

The individual intercommunication facilities use the following 
methods of communication: 

• CICS/VS function request shipping can use either VTAM or MRO 

• CICS/VS transaction routing must use MRO 

• CICS/VS distributed processing must use VTAM 
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The method of communication is specified through the ACCMETH=VT AM 
aild/or IRC operand in DFHTCT TYPERSYSTEM. 


HOW TO PROVIDE THE FACILITIES 


In addition to the system generation programs DFHSG PROGRAM=ISC, DFHSG 
PROGRAMMEIP (except for transaction routing), and DFHSG PROGRAM=TCP with 
ACCMETH=VTAM, VTAMDEV =LUTYPE6 (for a domain-remote connection) or 
ACCHETH=IRC (for a region-remote connection) , the following CICS/VS 
system tables must be specified to provide support for the CICS/VS 
intercommunication facilities: 

• DFHSIT,EXEC=YES,ISC=YES or xx. For MRO specify IRCSTRT=YES or use 
CEHT SET IRC OPEN command. 

• DFHPCT TYPE=GROUP,FN=ISC (or DFHPCT TYPB=ENTRY statements with the 
appropriate operands) . 

• DFHPPT TYPE=GROUP,FN=ISC (or DFHPPT TYPE=ENTRY statements with the 
appropriate operands). 

• DFHDCT TYPE=REMOTE for remote transient data destinations. 

• DFHFCT TYPE=REMOTE for remote files. 

• DFHPCT TYPB=REMOTE macro. 

• DFHTST TYPE=REMOTE for remote temporary storage gueues. 

• DFHDLPSB TYPE=ENTRY,SYSIDNT=name for remote DL/I PSBs under 
CICS/OS/VS. 

• A terminal control table with: 

- DFHTCT TYPE=INITIAL. 

- DFHTCT TYPE=SYSTEM with either ACCMBTH=VTAM for a domain-remote 
connection or ACCMETH=IRC for a region—remote connection. 

DFHTCT TYPE=SYSTEM with the SEND and RECEIVE operands if there 
are multiple parallel sessions with a remote system; 
alternatively, a separate DFHTCT TYPE=TERMINAL statement can be 
written for each session. 

For MRO sessions, the SEND and RECEIVE operands are reguired, 
and DFHTCT TYPE=TERMINAL cannot be used to define such 
sessions. 

- DFHTCT TYPE=REGION, SYSIDNT=name, or DFHTCT TYPE=REMOTE if 
TCTTE information is to be shared across regions. 

Noterlf transaction routing is to be used then the system that 
executes the user transaction must have in its terminal control table a 
definition of each of the terminals that can run that transaction from a 
remote system. Such terminals are defined using the DFHTCT TYPE=REGIOM 
or DFHTCT TYPE^REMOTE macro instructions. 

DFHTCT TYPE=FINAL• 
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RULES AND RESTRICTIONS 


| To create the best system design for his particular requirements, the 
I systems programmer must bear the following points in mind: 

| • Remote data resources can only be accessed by EXEC—level commands 

| or by transactions that run on the remote system. 

| • All programs, tables, and maps that are used by a transaction must 
| reside on the system that owns the transaction (the programs, 

I tables, and maps can be duplicated in as many regions as 

| necessary). 

| • A terminal associated transaction that is initiated by the 

| transient data trigger level facility must reside on the same 

| system as the transient data gueue that causes its initiation. 

| This restriction applies to both macro—level and command—level 

I application programs. 

| • Transaction initiated by macro level interval control requests must 

| reside on the same system as the transaction that initiated them. 

| •* BMS support must reside on each system that owns a terminal through 

j which paging commands can be entered. 

| • A BUS route request that specifies an operator or operator class in 
| its route list will direct output only to operators signed on at 

| terminals owned by the system on which the route request was 

j executed. 

| • The terminals listed in the terminal list table (DFHTLT) must 

| reside on the same system as the terminal list table. 

| • Communication between node error programs, user exits, and user 

| programs is the responsibility of the user. 

| • EDF running in two—terminal mode is not supported except when both 

| terminals and the user transaction reside on the same system, that 

| is, when no transaction routing is involved. 

| • Using EDF to check out a remote transaction is supported in single 
| terminal mode provided the routing transaction CRTE is used to 

| invoke both EDF and the transaction under test. 

I • The DFHTC CTYPE macros cannot be used for terminals that are owned 

| by remote systems. 

| • Terminals on remote systems cannot initiate asynchronous 

| transaction processing. 

| • 2260 and FASTER compatibility are not supported. 

| • Transaction routing using 7770 terminals is not supported. 

| • Transaction routing using pooled TCAtt terminals is not supported. 

| • Sync point ROLLBACK calls are not supported. 

| • Transaction routing does not support running CSMT from a remotely 

| owned 2780 for which BSCODE=ASCII is specified. 

| • Operator console in OS/VS is not supported. 
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For DOS/VS, the CANCEL, detach, DUMP, JDOHP-, and BOJ macros must 
not be issued by non—CICS code. If any of these macros are issued 
vhile the MRO facility is running, then the MHO environment is not 
terminated properly; this can lead to problems which can only be 
solved by a re—IPL. 

When transaction routing is being used in multiregion operation, 
the path between the terminal and the transaction is not allowed to 
turn back on itself. An example of this is if system A specifies 
that a transaction is on system B, system B specifies that it is on 
system C, and system C specifies that it is on system A; then an 
attempt to use that transaction from system A will be abended when 
system C tries to route back to system A. This restriction also 
applies if the routing transaction is used to establish all or part 
of a path that turns back on itself. 

The PRINTTO and ALTPRT operands for a VTAM terminal must (if 
specified) name a printer owned by the same system as the terminal 
being defined. 

For interregion communication use (MRO) with CICS/DOS/VS, it is 
recommended that module DFBIRP is made SVA—resident, in order to 
ensure inter partition integrity. 

For interregion communication use (MRO and DL/I shared data base) 
with CICS/OS/VS, it is recommended that module DFHCRC is made LPA— 
resident, in order to ensure interregion integrity in case a 
CICS/VS system abend occurs. 

If a transaction is started by Automatic Transaction Initiation 
(ATI) on a remotely owned terminal, then the transaction must be 
defined on the terminal owning system as being remote and to be 
executed on the system where the ATI request was issued. 

The user area of the TCTTE is updated at task attach, user 
synchronization point, and task detach times. Therefore, a user 
exit program running on the terminal owning system and examining 
the user area while the terminal is executing a remote transaction 
will not necessarily see the same values as a user exit running at 
the same time in the transaction owning system. Note also that the 
user areas must be defined as having the same length in both 
systems. 

Application programs that use the DFHTC TIPE-SIGNAL macro 
instruction without the WAIT option may behave differently when 
running on a remotely owned terminal. This is because the signal 
indicator is only passed to the application when a terminal control 
request with a WAIT implied is issued by the application program. 

If the application does not issue such a request then continually 
testing the signal indicator by means of DFHTC TIPE^SIGNAL macro 
instruction will continually fail to detect the inbound signal. 

Transaction identifiers are translated from local names to remote 
names when a request to execute a transaction is transmitted from 
one CICS/VS system to another. However, the nominated transaction 
identifier specified in an EXEC CICS RETURN command or a DFHPC 
TYPB^RETURN macro is not translated when it it transmitted from the 
transaction owning system to the terminal owning system. 
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Terminal identifiers are translated from local names to remote 
names when a transaction routing request to execute a transaction 
on a specified terminal is shipped from one CICS/VS system to 
another. However if an EXEC CICS START command specifying a 
terminal identification is function shipped from one CICS/VS system 
to another, then the terminal identification is not translated from 
local name to remote name. 

Transaction that recover input messages for protected tasks after a 
system crash must run on the same system as the terminal that 
invoked the protected task. 

The transactions CEOT and CSOT are not supported by the transaction 
routing facility. 

Only locally owned terminals can be queried and modified by the 
master terminal transactions CSHT and CEMT. The only terminals 
visible to these transactions are those owned by the systems on 
which the master terminal transaction is actually running. 

For IRC usage (MRO) on CICS/DOS/VS, module DFHSCTE must be made 
SVA—resident. 

The SIT, or system initialization overrides, must not specify 
SRT=NO• 
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Part 4. Recovery/Restart 




Chapter 4.1. Introduction 


This part of the manual describes the types of problems that can lead to 
CICS/VS recovery and restart facilities being used, the CICS/VS—provided 
functions to handle error conditions, and the facilities that are 
available to the system programmer to modify or extend these CICS/VS 
functions to suit the particular working environment. Figure 4.1—1 
summarizes the information in this part of the manual. 


1- 

| Error situation 

| CICS/VS function 

1 

1 

| Modifications avail— 

| able to the system 
| programmer 

|Chapter 

“i 

| Terminal error 

| Sample Terminal 

| User—written Terminal 
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| Error Program 

| Error Program 

i 

| 4.2 


| Logical unit 
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| Sample Node Error 

1 
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| Transaction 
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| Abend exit 
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| User-written abend 
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Figure 4.1—1. Recovery/Restart Organization 
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Chapter 4.2. The Terminal Error Program 


This chapter contains information on the CICS/VS terminal error program 
that handles error conditions for devices that operate in a non—SNA 
environment. The CICS/VS—supplied sample terminal error program and the 
user—written version (s) of this program are discussed, as well as error 
condition related information for specific device types. The 
alternative terminal error program interface to CICS/VS, which provides 
information on how to generate a terminal error program that can be used 
on a pre—VS system, is also discussed. 

CICS/VS terminal error—handling is based on the assumption that most 
users will want to modify certain CICS/VS operations in response to 
various terminal errors. Because it is impossible for CICS/VS to 
anticipate all courses of action, the error—handling facilities have 
been designed to allow maximum freedom in providing unique solutions for 
errors occurring within a terminal network. 

The following CICS/VS components are involved in the detection and 
correction of errors that occur when BTAH and/or TCAM terminals are 
used: 

• Terminal error program (DFHTEP) 

• Terminal control program (DFHTCP) 

• Terminal abnormal condition program pFHTACP) 

The corresponding CICS/VS components for logical units are discussed 
in Chapter 4.3, «The Node Error Program. 11 

I Note : Node error programs, not terminal error programs, must be used 
| for TLX and TWX devices that are being used as LUTIPE1 logical units 
I under VTAM. 


WHEN AN ABNORMAL CONDITION OCCURS 


When an abnormal condition associated with a terminal or line occurs, 
the terminal control program places the terminal out of service and 
passes control to the terminal abnormal condition program (DFHTACP), 
which, in turn, passes control to a version of the terminal error 
program (DFHTEP) (either CICS/VS-supplied or user—written) so that it 
can take the appropriate action. 
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TERMINAL CONTROL PROGRAM 


When the terminal from which the error has been detected has been placed 
out of service, the terminal control program creates a terminal abnormal 
condition line entry (TACLE), which is chained off the real entry 
(TCTLE) for the line on which the error occurred. The TACLE contains 
all the error information necessary for proper evaluation of the error, 
plus special action flags that can be manipulated to alter the error 
correction procedure. 


TERMINAL ABNORMAL CONDITION PROGRAM 


After the TACLE has been established, a task that executes DPHTACP is 
then attached by the terminal control program and is provided with a 
pointer to the real line entry (TCTLE) on which the error occurred. 

After performing basic error analysis and establishing default actions 
to be taken, DFHTACP gives control to DFHTEP by issuing a program 
control LINK request. DFHTACP passes the address of the TACLE so that 
DFHTEP can examine the error and provide an alternative course of 
action. 

Once DFHTEP has performed the desired function, it returns control to 
DFHTACP by issuing a program control RETURN request. DFHTACP then 
performs the necessary actions as dictated by the action flags within 
the TACLE; the error—handling task then terminates. 

Notes : 

1. Special consideration should be given to prevent data security 
violation. For example, if a terminal is put out of service for 
some time or until the cause of the failure is removed, the 
original operator may no longer be present, although the sign—on 
information will still be in the TCTTE when the terminal is put 
back into service. (See also the note following "Format Description 
of the TACLE DSECT" under "Sample Terminal Error Program Messages" 
later in this chapter.) 

| 2. To avoid system degradation, if DFHTACP has more than eight errors 

| on a line before action can be taken, the line will be put out of 

j service. 


TERMINAL ERROR PROGRAM 


The terminal error program analyzes the cause of the terminal or line 
error that has been detected by the terminal control program. The 
CICS/VS—supplied version (the sample terminal error program) is designed 
to attempt basic and generalized recovery actions, while a user-written 
version of this program can be provided to handle specific application- 
dependent recovery actions. The user—written terminal error program is 
linked to in tbe same way as the CICS/VS—supplied version by tne 
terminal abnormal condition program, and equally, information relating 
to the error is carried in the terminal abnormal condition line entry 
(TACLE) . 

The macros and operands that are provided for generating the sample 
terminal error program are described in the sections that follow; the 
main steps are generating the sample DFHTEP module and tables by means 
of the DFHTEPM and DFHTEPT macros, respectively. The system programmer 
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can select the appropriate options in this sample program on which the 
user—written version can be based. If so desired, a dummy terminal 
error program, which invokes no action other than a program control 
return operation to DFHTACP, can be generated by means of the DFHSG 
PROGRAM=CSO macro described in Chapter 2.2. 

A description of the CICS/VS—supplied sample terminal error program 
appears later in this chapter; advice on how to generate a user—written 
version is also given later in this chapter. 


TERMINAL ABNORMAL CONDITION LINE ENTRY (TACLE) 


The terminal abnormal condition line entry (TACLE) is the basic 
interface that is used by the sample DFHTEP and should be used by a 
user—written DFHTEP to determine the nature of the error that occurred 
and to indicate what course of action is to be taken. 

Before giving control to DFHTEP, DFHTACP establishes certain default 
actions to be taken, depending upon the particular error condition that 
has been detected. The default actions are indicated by appropriate bit 
settings in the one—byte fields of the TACLE labeled TCTLBBCB+1 and 
TCTLEECB+2. The default actions and bit settings are listed in Appendix 
E. 

Note: For a detailed discussion of these action bits, and the dummy 

terminal indicator, see the discussion under "User—Written Terminal 
Error Programs 11 later in this chapter. The write-abort bit (X , 01 t in 
TCTLEECB+1) is always set with the abend—task bit (X , 04 i ) as part of 
action 3, but both bits are suppressed if "dummy terminal" is indicated. 

The code indicating the particular error condition detected is passed 
to DFHTEP in the one—byte field of the TACLE labeled TCTLEPFL. These 
DFHTACP message codes, error codes, conditions, and DFHTACP default 
actions are also listed in Appendix E. 

A diagram of the terminal abnormal condition line entry (TACLE) DSECT 
is provided under "Oser—Written Terminal Error Programs" later in this 
chapter. 


THE SAMPLE TERMINAL ERROR PROGRAM 


CICS/VS provides a sample terminal error program (DFHTEP) that can be 
used as a generalized program structure for handling terminal errors. 
None of its components are generated as part of the standard CICS/VS 
generation process, but may instead be generated as described in this 
section. 

The user can generate and use the sample terminal error program with 
default options provided, or can tailor the terminal error support to 
the needs of the operating environment by selecting the appropriate 
generation options and variables. In addition, because each error 
condition is processed by a separate routine, the system programmer may 
replace a CICS/VS provided routine with a user—written one when the 
sample DFHTEP is generated. 
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COMPONENTS 


The sample terminal error program consists of the terminal error program 
itself and two terminal error program tables: 

• The TEP error table 

• The TEP default table 

Both tables contain ••threshold” limits defined for the various error 
conditions to be controlled and accounted for by the sample DPHTEP. A 
••threshold” limit may be thought of as the number of error occurrences 
that are permitted for a given type of error on a given terminal before 
the sample DPHTEP accepts the DFHTACP default actions. Optionally, the 
number of occurrences can be controlled and accounted for over- 
prescribed time intervals (for example, if more than three of a given 
type of error occur in an hour, the terminal will be placed out-of- 
service) • | 


TEP Error Table 


The TEP error table maintains information about a terminal and the 
errors that have occurred on the terminal. The table consists of three 
parts, which are depicted xn Figure 4.2—1, below. 

• TEP error table header — Contains addresses and constants related 
to the location and size of the TEP error table components. 

• Permanent and 

• Reusable terminal error blocks (TEBs) 

TEBs maintain error information associated with each terminal. The 
user is required to specify the total number of TEBs to be generated, 
and can permanently reserve TEB space for specific terminals that are 
critical to the system. Those TEBs that are not permanently reserved 
are considered reusable, and are assigned dynamically upon the first 
occurrence of an error associated with a particular terminal, and are 
released for reuse whenever the appropriate error processor places the 
terminal out—of—service. By reusing TEB space, the user normally 
requires fewer TEB entries than the total number of terminals in the 
network. 


TEP Error Table 
Header (TETH) 


Permanent 
Terminal 
Error Blocks 
(P-TEBs) 


Reusable 
Terminal 
Error Blocks 
(R-TEBs) 


Figure 4.2—1. TEP Error Table 
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Each TEB currently in use or permanently reserved contains the 
symbolic terminal identification assigned to the terminal and one or 
more error status elements (ESEs) as shown in Figure 4.2—2, below. An 
ESE records the occurrence of a particular type of error associated with 
the terminal. The contents of an error status element are described in 
the TEPCD DSECT (generated by the DFHTEPM TYPE-INITIAL macro) under the 
comment ”ERROR STATUS ELEMENT FORMAT”• The number of ESEs per TEB 
remains constant for all TEBs and is specified by the user when the TEP 
tables are generated. If less than the maximum number of error types 
| recognized by DFHTACP (25 for VSE or 26 for OS/VS) is specified, one 
additional ESE, referred to as the common error bucket, is generated for 
each TEB. The user may permanently reserve ESE space in each TEB for 
specific error types. Those not permanently reserved are considered 
reusable, and are assigned dynamically upon the first occurrence of a 
particular error type associated with the terminal. If an error type 
occurs that is not currently represented by an ESE, and if all reusable 
ESEs are assigned to other error types, the occurrence of this error is 
recorded in the common error bucket. The number of error types that can 
occur in a typical terminal network is far less than the number 
recognized by DFHTACP. By specifying less than the maximum and allowing 
the sample DFHTEP to assign ESEs dynamically, the user can minimize the 
table size and still control and account for the types of errors 
relevant to the network. 


SYMBOLIC 

TERMINAL 

ID 


ERROR 

STATUS 

ELEMENT 



COMMON 

ERROR 

BUCKET 


Figure 4.2—2. Terminal Error Block (TEB) 


TEP Default Table 


The TEP default table contains the threshold limits for each type of 
error to be controlled and accounted for. An index array at the 
beginning of the default table serves a dual function. If the value in 
the index is positive, the error code has a permanently defined ESE in 
each TEB and the index value is the displacement to the reserved ESE. 

If the index value is negative, an ESE must be assigned dynamically from 
a reusable ESS if one has not already been created by a prior 
occurrence. The complement of the negative index value is the 
displacement to the threshold limits for the error type retained in the 
TEP default table. 
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DESCRIPTION OF THE SAMPLE TERMINAL ERROR PROGRAM 

The structure of the sample terminal error program (DFHTEP) can be 
broken into six major areas as follows: 

• General entry and initialization 

• Terminal identification and efror code lookup 

• Error processor selection 

• Error processing execution 

• General exit 

• Common subroutines 

These areas are described in detail in the sections that follow. 

Figure 4.2—3 at the end of this section gives an overview of the 
structure of the sample terminal error program. 


General Entry and Initialization 


Upon entry, the sample DFHTEP establishes base registers and 
addressability to the various control blocks needed to process the error 
(TACLE, TCTTE, TEP tables). If time support has been generated, an 
interval control request is issued to timestamp the error for subsequent 
processing. The first entry into the sample DFHTEP after the system was 
initialized causes the TEP tables to be initialized. 


Terminal Identification and Error—Code Lookup 


After the general entry processing, the TEP error table is scanned for a 
terminal error block (TEB) entry for the terminal associated with the 
error. If no matching entry is found, a new TEB is created. If all 
TEBs are currently in use (if no reusable TEBs are available) the 
processing is terminated and a DFHPC RETURN reguest is issued giving 
control back to DFHTACP, where default actions are taken. Once the 
terminal*s TEB has been located or created, a similar scan is made of 
the error status elements (ESEs) in the TEB to determine whether the 
type of error currently being processed has occurred before or if it has 
permanently—reserved ESE space. If an associated ESE is not found, an 
ESE is assigned for the error type from a reusable ESE. If a reusable 
ESE does not exist, the error is accounted for in the terminal*s common 
error bucket. The addresses of the appropriate control areas (TEB and 
ESE) are placed in registers for use by the appropriate error processor. 
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Error—Processor Selection 


User—specified message options are selected and the messages are written 
to a specified transient data destination. The type of error code is 
used as an index into a table to determine the address of an error 
processor to handle this type of error. If the error code is invalid or 
the sample DFHTEP was not generated to process this type of error, the 
address points to a routine whicn (optionally) generates an error 
message and returns control to DFRTACP, where default actions are taken. 
If an address of a valid error processor is obtained from the table, 
control is passed to that routine. 


Error Processing Exe cution 


The function of each error processor is to determine whether the default 
actions established by DFHTACP for a given error or the actions 
established by the error processor are to be performed. The common 
error bucket is processed by the specific error processor. However, the 
threshold limits of the common error bucket are used in determining 
whether the limit has been reached. Subroutines are provided in the 
sample DFHTEP to maintain count and time threshold totals for each error 
associated with a particular terminal to assist the error processor in 
making its decision. Also available are subroutines for logging the 
status of the error and any recovery action taken by the error 
processor. 

The system programmer can replace any of the error processors 
supplied with the sample DFHTEP with user—written ones. Register 
linkage conventions, error conditions, DFHTACP default actions, and 
sample DFHTEP error processor actions are described in comments found in 
the sample DFHTEP source listing. However, sample DFHTEP actions, in 
many cases, can be altered by changing the threshold limits when 
generating the TEP tables. 


General Exit 


Control is passed to this routine from each error processor. This 
routine determines whether the terminal is to remain in service. If the 
terminal is to be put out-of—service, the terminal error block and all 
error status elements for that terminal will be deleted from the TEP 
error table unless the terminal was defined as a permanent entry. When 
the terminal is placed back in service, a new terminal error block will 
be assigned should a subsequent error occur. 


Common Subroutines 


A number of subroutines are provided in the sample DFHTEP for use by the 
error processors. Each subroutine entry has a label of the form 
'•TEPxxxxx” where "xxxxx" is the subroutine name. All labels within a 
subroutine start with TEPx where M x M is the first character of the 
subroutine name. All subroutines are arranged within the module in 
alphabetical order in the subroutine section. Register conventions and 
use of the subroutine may be found as comments at the beginning of each 
subroutine in the source listing. The following subroutines are 
available to users who elect to write their own error processors: 
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TSPACT 


Used to output the names of the action bits set by DFHTACP and 
the sample DFHTEP in the fields TCTLEECB+1 and TCTLEECB +2 of 
the TACLE if appropriate PRINT options are selected when the 
program is generated. 


TEPDE L 

Used to delete the terminal error block and error status 
elements for a terminal from the TBP error table on exit from 
an error processor. 

TEPHEXCN (Used by TEPPUTTD) 

Used to convert a four—bit hexadecimal value to its eight-bit 
printable equivalent. 

TEPINCR 

Used to update and test the count/time threshold totals 
maintained in the terminals error status element. 

TEPLOC 

Used to locate or assign terminal error blocks and error status 
elements for a terminal identification. 


TEPPUTTD 

Used to output character or hexadecimal data to a user—defined 
transient data destination. 


TEPTMCHK (Used by TEPINCR) 

Used to determine if the time threshold limit has expired. 


TBPWGHT 

Used to update the weight/time threshold values maintained in 
the terminal's error status elements. 
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DFHTACP 




DFHTACP 


Figure 4.2—3. Sample DFHTEP Overview 


SAMPLE TERMINAL ERROR PROGRAM MESSAGES 


The messages logged to the transient data destination CSMT (or 
optionally, to the destination specified in the OPTIONS operand of 
DFHTEPM TTPE=INITIAL) are of six types, each identified by a unique 
message prefix. The selection of each type of message is controlled by 
the user through the appropriate parameters specified in the PRINT 
operand of DFHTEPM TYPE=INITIAL• These messages are: 

DFHTEP, ERROR — error text 

During DFHTEP module generation, the PRINT parameter specified 
ERRORS. This message may be suppressed by using the NOERRORS 
option. The error text will be one of the following: 

Unsupported error code, «xx» 

The error code presented to DFHTEP by DFHTACP is unknown by 
DFHTEP. 
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"DFHTEPT" not defined in system. 

The DFHTEP table could not be loaded into storage. 

Unknown error status message, ,, xxxx" 

The error status message presented from a remote 3270 type 
device could not be decoded. 

None of these errors should occur. 


DFHTEP, ACTION — action flag names 

During DFHTEP module generation, the PRINT parameter specified 
TACPACTION or TEPACTION or both. If both are specified, this 
message is logged twice each time DFHTEP is called. The first 
message indicates the action flags as set by DFHTACP on entry 
to DFHTEP. The second massage indicates the action flags as 
returned to DFHTACP by DFHTEP after error processing. These 
messages may be suppressed by using the NOTACPACTION and 
NOTEPACTION options. 

The action flag names and descriptions are listed below. To better 
understand the actions taken by DFHTACP, see the discussion of the 
TCTTEECB+1 and TCTTEECB+2 fields contained in the TACLE DSECT 
description in "User—Written Terminal Error Programs' 1 later in this 
chapter. 


LINBOS 

NO PURGE 

SW LINE DISCON 

DISCON SW LINE 

TERMOS 

ABEND 

NO POLL 

ABORTWR 

REL TCAM TIOA 


DFHTEP, TID — tid 

During the DFHTEP module generation the PRINT parameter 
specified TID. This message contains the symbolic terminal 
identification of the device associated with the error. This 
message may be suppressed by using the NOTID option. 


DFHTEP, DECB — DECB information 

During the DFHTEP module generation, the PRINT parameter 
specified DECB. This two line message contains the DECB 
(printed in hexadecimal) of the terminal causing the error. 
The DECB is contained in the TACLE (displacement +16 
[decimal]). See the TACLE DSECT described in '•User—Written 
Terminal Error Programs." This message may be suppressed by 
using the NODECB option. 


DFHTEP, TACLE — TACLE information 

During the DFHTEP module generation, the PRINT parameter 
specified TACLE. This message (printed in hexadecimal) will 
contain the first 16 bytes of the TACLE passed to DFHTEP by 
DFHTACP. See the TACLE DSECT described in "User-Written 
Terminal Error Programs." This message may be suppressed by 
using the NOTACLE option. 


Line Out of Service 

Non—purgeable Task Exists on Terminal 
Switched Line Disconnected 
Disconnect Switched Line 
Terminal Out of Service 
Abend Transaction 

Take Control Unit Off Polling List 
Abort Write Request on Task abend 
Release TCAM TIOA (OS/VS only) 
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DFHTEP, ESE — ESE information 

During the DFHTEP module generation, the PRINT parameter 
specified ESE* This message contains the error status element. 
The message may be suppressed by using the NOESE option. 

An ESE will be either 6 bytes or 12 bytes long depending on whether the 
TIME option was specified when generating the TBP tables. Both formats 
are described below. 


NOTIME 

Displ . Length (byte s) 


TIME 


0 

2 

4 

5 


2 Error threshold counter or weight value 

in binary 

2 Current error count or weight value in binary 

1 Error code 

1 Not used 


Displ* Length (bytes) 


0 

5 

8 


5 Same as described in NOTIME above. 

3 Timed threshold value in hundredths 

of a second. 

4 Time of first occurrence of this 

error. Time given as binary integer 
in hundredths of a second. 


GENERATING THE SAMPLE TERMINAL ERROR PROGRAM 


The sample DFHTEP and the TEP tables are generated independently of each 
other. However, some of the parameters specified in the DFHTBPM and 
DFHTEPT macro instructions are related and care must be taken to ensure 
compatibility. The parameters concerned are identified in the 
descriptions of the macros later in this chapter. 

If the sample DFHTEP is used, there are additional requirements which 
should be considered during PCT and PPT generation. These are as 
follows: 

| 1. The task executing the sample DFHTEP module requires a TWASIZE of 

| 20 fullwords (eighty bytes) in addition to the TWASIZE supplied by 

CICS/VS for DFHTACP (transaction CSTE). 

2. The TEP table (DFHTEPT) must be specified in the PPT. The module 
should be specified with RES=YES, because once the table is loaded 
into storage, it is never deleted. If the module is specified with 
RES=YES it prevents the possibility of fragmenting the dynamic 
area. See ”Processing Program Table” in Appendix A. 
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Job Control f o r Ge n erating the Sample Terminal Error Program 


The generation of the sample terminal error program consists of two 
separate assembly and iink-nsdit steps, one to create the sample DFHTEP 
module itself, and the other to create the TEP tables. Refer to the 
information on the preparation of application programs in the 
| appropriate CICS/VS System Programmer»s Guide (OS/VS or DOS/VS) for the 
job control statements necessary to assemble and link—edit these 
components. The names under which the components must be link-edited 
are: 

| DFHTEP - Sample DFHTEP module 
DFHTEPT - Sample DFHTEP table 


G enerate the Sample DFHTEP Module — DFHTEPM 


The sample DFHTEP module is generated by the following macro 
instructions: 

• DFHTEPM TYPE=INITIAL - to control the printing of CICS/VS DSBCTs, 
provide optional routines, and indicate the type of information to 
be logged when errors occur. 

• DFHTEPM TYPE^ERRPROC - to allow the user to replace the error 
processors supplied with the sample terminal error program with 
user—written versions. 

• DFHTEPM TYPB=ENTRY - to code a user "ENTRY* 1 exit. 

• DFHTEPM TYPE=EXIT - to code a user "EXIT” exit. 

• DFHTEPM TYPE=FINAL - to indicate the end of the sample DFHTEP 
module. 


i i i ..■ 1 ■ ... - ' .. "■ 



IDFHTBPM 

1 

TYPE=INITIAL 



1 

I 

[,DSECTPR={YES|NO}] 



1 


[ ,OPTIONS=([TD| (TD,destid) | NOTD ] 



1 

1 

[,327081,N03270R] 




1 

£ ,7770 | ,N07770] 



1 

1 

r ,EXITS|,NOEXITS 1 




1 

[,TIME|,NOTIME] 




1 

[ ,TCAM| ,N0TCAM ]) ] 



i 

1 

{ »PBINT= (f ERRORS 1 NOERRORS 1 



1 

1 

r .TACPACTION1.NOTACPACTION1 



! 

1 

T.TEPACTION1»NOTEPACTION 1 



1 

1 

[#TID|»N0TID] 



1 

1 

[,decbi,NODBCB] 



1 

1 

r,TACLEI,NOTACLB1 



1 

1 

[ ,BSE | ,NOESE ]) } 



i-1-1_i 


TYPE=INITIAL 

establishes the beginning of the generation of the sample 
DFHTEP module itself. 
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DSECTPR={YES|NO} 

is used to control the printing of CICS/VS DSECTs on the sample 
DFHTEP assembly listing. Its purpose is to reduce the size of 
the listing. The default is DSECTPR=YES. 


YES 

means that printing of the DSECTs will be allowed. 


means that printing of selected CICS/VS DSECTs will be 
suppressed. This parameter should not be used under 
Assembler F. 


OPTIONS=optional—routines 

is used to include or exclude optional routines in the DFHTEP 
module. The parentheses are required even when only one option 
is specified. If this operand is omitted all default options 
are generated. Valid options are: 

TD or (TD, destid) or NOTD 

is used to specify whether information regarding the errors 
is to be written to a transient data destination. 

TD 

means the transient data output routine is to be 
generated. The implied transient data destination is 
CSMT. 

(TD, destid) 

means the transient data output routine is to be 
generated. The messages are sent to the destination 
specified by "destid 11 . (See the DESTID operand in the 
DFHDCT TYPE=EXTRA macro instruction in Chapter 3.2 of 
this manual.) 


NOTD 

means no messages are to be written to a transient data 
destination. 

327OR or N03270R 

is used to specify whether optional remote 3270 support is 
to be included. 

3270R 

means remote 3270 errors are to be supported. More 
specifically r error codes 89 and 9D are supported. If 
the user wishes to supply his own error processor 
routines for these codes, 3270R must be specified or 
allowed to default. 

NO3270R 

means no remote 3270 support is to be generated. 

7770 or NO7770 

is used to specify whether optional 7770 support is to be 
included. 

7770 

means 7770 errors are to be supported. More 
specifically error code 8A is supported. If the user 
wishes to supply his own error processor routine for 
this code, 7770 must be specified or allowed to 
default. 
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N07770 

means no 7770 support is to be generated. 

EXITS or NOEXITS 

is used to specify whether ”ENTRY 11 and "EXIT* user exit 
support is to be included. The default is NOEXITS. 

EXITS 

means that branches will be taken to ENTRY and EXIT 
exit routines before and after error processing. Dummy 
exits are provided if user exits are not used. 

NOEXITS 

indicates that no branches will be taken to user exit 
routines. 

TIME or NOTIME 

is used to specify whether threshold limit tests are to be 
controlled over prescribed time intervals. An example 
might be placing a terminal out-of—service if more than 
three instances of a given type of error occur in one hour. 
The parameter must be the same as the OPTIONS operand in 
the DFHTEPT TYPE=INITIAL macro instruction. 

TIME 

means this type of ••threshold” testing is to be 
supported. 

NOTIME 

means this type of "threshold” testing is not to be 
generated. 

TCAM or NOTCAM 

is used to specify whether optional TCAM support is to be 
included (CICS/OS/VS only). 

TCAM 

indicates that TCAM error code •9P I is to be supported. 
NOTCAM 

indicates that TCAM error code • 9F 1 is not supported. 


PRINT=print—information 

is used to specify which types of information are to be logged 
to the transient data destination each time an error occurs. 

If NOTD is specified on the OPTIONS operand, all PRINT 
parameters default to NO. All PRINT parameters require the 
transient data output routine. The parentheses are required 
even when only one parameter is specified. 

ERRORS or NOERRORS 

is used to specify whether unprocessable conditions 
detected by the sample DFHTEP are to be recorded on the 
transient data destination. 

ERRORS 

means error messages are to be logged. 

NOERRORS 

means no error messages are to be logged. 

TACPACTION or NOTACPACTION 

is used to specify whether DFHTACP default actions are to 
be recorded on the transient data destination. 
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TACPACTION 

means the default actions are to be logged. 

NOTACPACTION 

means no default actions are to be logged. 

TEPACTION or NOTEPACTION 

is used to specify whether the actions selected as a result 
of sample DFHTEP processing are to be recorded on the 
transient data destination. 

TEPACTIO N 

means the final actions are to be logged. 

NOTEPACTION 

means no final actions are to be logged. 

TID or NOTID 

is used to specify whether the symbolic terminal 
identification of the terminal associated with an error is 
to be recorded on the transient data destination. 

TID 

means the terminal identification is to be logged. 

This is the default parameter. 

NOTID 

means no terminal identifications cure to be logged. 

DBCB or NODECB 

is used to specify whether the DECB of the line associated 
with error is to be recorded on the transient data 
destination. 

DEC B 

means the DECB is to be logged. The hexadecimal 
representation of the DECB is logged as two 24—byte 
messages. This is the default parameter. 

NODECB 

means no DECB logging is to occur. 

TACLE or NOTACLE 

is used to specify whether the TACLE prefix is to be 
recorded on the transient data destination. 

TACLE 

means the 16—byte TACLE prefix as received from DFHTACP 
is to be logged. This is the default parameter. 

NOTACLE 

means no TACLE prefix logging is to occur. 

ESE or NOESE 

is used to specify whether the ESE associated with the 
error is to be recorded on the transient data destination. 

ESE 

means the ESE, after being updated, and before being 
deleted (if the action puts the terminal out-of- 
service) is to be logged. This is the default 
parameter. 

NOESE 

means no ESE logging is to occur. 
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Error Processor Source 


Comments contained in the sample DFHTEP provide guidance on how to 
prepare error processor routines, particularly with regard to register 
and subroutine linkage conventions. The routines must also adhere to 
the following restrictions: 

• The error processor must be coded in assembler language. 

• The first executable statement in the routine must be labeled 
TEPCDxx, where "xx" is the error code specified in the DFHTEPM 
TYPE=ERRPBOC r CODE=errcode macro instruction, which follows. 

• In addition to the register usage conventions and restrictions 
stated in the sample DFHTEP source, the contents of registers 12 
and 13 (TCA and CSA base registers) must not be disturbed. The 
sample DFHTEP executes as a group of non terminal—dependent tasks 
under CICS/VS, and each has its own TCA during the processing of 
each terminal error. 

• The error processor must exit to the sample DFHTEP symbolic label 
TEPRET. 

The macro instruction required for a user '•ENTRY** exit is: 


i - 1 - 1 - •- 1 

| |DFHTEPM| TYPE=ENTRY | 

i_i_i_i 

This macro must De immediately followed by user ••ENTRY** exit code, 
starting with the label *»TEPENTRY•• and ending with a BR 14 instruction. 

The macro instruction required for a user "EXIT" exit is: 



i-1- 

IDFHTEPM| TYPE=EXIT 


L 


L 



This macro must be immediately followed by user '•EXIT** exit code, 
starting with the label "TEPEXIT** and ending with a BR 14 instruction. 


Replace Error Processors — DFHTEPM TYPB=ERRPROC 


The macro instruction necessary to replace error processors supplied 
with the sample DFHTEP with user—written error processors is as follows: 

i-1- r . . - . . —.—... 1 .. . . - . .....—.— ‘" “ i 

| fDFHTEPM| TYPE=ERRPROC | 

I | I ,CODE=errcode j 

| | | (followed by the appropriate error j 

| | | processor source statements) | 

i_i_i_i 
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TYPE^ERRPROC 

indicates that a CICS/VS—supplied error processor routine is to 
be replaced with the user—written error processor which 
immediately follows the macro instruction. This macro 
instruction is optional; if used, the macro must follow the 
DFHTEPM TYPE=INITIAL macro. One DFHTEPM TYPB=ERRPROC macro 
must precede each user-written error processor source routine. 


CODE=errcode 

is used to identify the error code assigned to the appropriate 
error condition. These codes are listed in the section "Format 
Description of TACLE DSECT." As an example, the 7770 timeout 
error condition would be entered as C0DE=8A. 


End of Sample DFHTEP Module — DFHTEPM TYPB=FINAi 


The macro instruction to terminate the sample DFHTEP module is: 

i-1-1-1 

| IDFHTEPtf| TYPE=FINAL | 

i-1-1_i 

| followed by an END DFHTEPNA statement. 


DFHTEPM Macro Examples 


1. The following is an example of the minimum number of statements 
reguired to generate a sample DFHTEP module: 

DFHTEPM TYPE=INITIAL 

DFHTEPM TYPE=FINAL 

| END DFHTEPNA 

This example generates a sample DFHTEP module with CICS/VS-supplied 
error processors and all default options. 

2. The following is an example of a more tailored sample DFHTEP 
module: 
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♦ NODULE specifications 


DFHTEPM TYPE=INITIAL , * 

OPTIONS=((TD # TEPQ) ,N07770 ,EXITS) , * 

PRINT= (NOTEPACTION, NOTACPACTION ) , * 

DSECTPR=NO 

* USER-SUPPLIED ERROR PROCESSORS 
DFHTEPM TYPE=ERRPROC,CODE=81 

TEPCD81 DS OH 

— error processor "81” source statements 


B 

DFHTEPM 
TEPCD9C DS 


TEPRET 

TYPE=ERRPROC,CODE=9C 
OH 


error processor "9C" source statements 


B TEPRET 

* USER "EXIT" EXIT CODE 
DFHTEPtt TYPE=EXIT 

TEPEXIT DS OH 


Additional user source statements to be executed after error processing: 


BR R14 

* CONCLUDE MODULE GENERATION 

DFHTEPM TYPE=FINAL 

END DFHTEPNA 

In this example no 7770 support is generated, but remote 3270 support 
and time interval ••threshold” testing support are provided. All default 
types of information except for TACP and TEP actions are to be logged to 
the TBPQ transient data destination. The CICS/VS DSECTs will not be 
printed on the sample DFHTEP assembler listing. The user has supplied 
two error processor routines (codes 81 and 9C respectively). 


Generate the Sample DFHTEP Tables — DFHTEPT 


The following macro instructions are required to generate the terminal 
error program tables: 

• DFHTEPT TYPE=INITIAL — to establish the control section. 
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• DFHTEPT TYPE^PERMTID — to define permanently reserved terminal 
error blocks (TEBs) for specific terminals. 

• DFHTEPT TYPE=PERMCODE|ERRCODE — to define permanently reserved 
error status elements (ESEs). 

• DFHTEPT TYPE=BUCKET — to account for specific error conditions to 
be accounted for in the common error bucket. 

• DFHTEPT TYPE=FINAL — to end the set of DFHTEPT macros. 


Control Section — DFHTEPT TYPB=IMITIAL 


The DFHTEPT TYPE=INITIAL macro instruction necessary to establish the 
control section for the TEP tables is: 


| |DFHTEPT| TYPB=IHITIAL 

j j | ,HAXTIDS=number 

| \ | [ ,MAXERRS={25 (VSE) or 26 (OS/VS) | number} ] 

| | | [ ,OPTIONS= {TIME | NOTIME} ] 


TYPE=INITIAL 

establishes the beginning of the generation of the TEP tables. 


HAXTIDS=number 

is used to specify the total number of permanent and reusable 
terminal error blocks to be generated in the TEP error table. 
Permanent entries are defined by the DFHTEPT TYPE=PERMTID macro 
instruction described later in this section. Any entries not 
defined as permanent will be reused when the terminal is taken 
out of service, or will be deleted at the request of an error 
processor. If an error occurs, and no TEB space is available, 
the error is not processed, and DFHTACP default actions are 
taken. The minimum number is 1. A maximum number is not 
checked for but should be no greater than the number of 
terminals in the user*s network. This parameter is required . 


MAXERRS=number 

is used to specify the number of errors to be recorded for each 
terminal. This value determines the number of permanent and 
reusable error status elements in each TEB. The maximum number 
| which may be specified is 25 for VSE and 26 for OS/VS. (These 

are also the default values.) If more are requested, only the 
maximum will be generated. If fewer are requested, one extra 
ESE will be generated for each TEB. The extra ESE is the 
common error bucket. Permanently reserved ESEs are defined by 
the DFHTEPT TYPE=PERHCODE macro instruction described later in 
this section. Any ESEs not defined as permanent will be 
dynamically assigned upon the first occurrence of a non- 
permanent error type associated with the terminal. By defining 
a number less than the maximum, and allowing the sample DFHTEP 
to dynamically assign ESEs, the user can minimize the size of 
the table and still control and account for the error types 
relevant to the network. The minimum number that can be 
specified is zero. In this case only a common error bucket 
will be generated. 
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0 PT10 NS ={TIME|NO TIM E} 

is used to specify whether time threshold space is to be 
reserved in support of the TIME option specified in the DFHTEPM 
TYPE-INITIAL macro instruction. The default is 0PTI0NS=TIME. 

TIME 

means time threshold space will be reserved. 

NOTIME 

means time threshold space will not be reserved. 


Define Terminal Error Blocks — PFHTEPT TYPE=PSRMTID 


The DFBTEPT IYPE=PERMTID macro instruction to define permanently 
reserved terminal error blocks for specific terminals is as follows: 

r- 1 4 . ™ ” r m 

| |DFHTEPT| TYPE=PERMTID 

| | l r TRMIDNT=name 

I_I_L_ 


T 

I 

I 

J 


TYPE=PERMTID 

defines permanently reserved terminal error blocks for specific 
terminals. Permanent TEBs are defined for terminals that are 
critical to system operation to ensure that error processors 
will always be executed in the event of errors associated with 
that terminal. If no permanent TEBs are to be defined this 
macro instruction is not required. A separate macro 
instruction must be issued for each permanently reserved TBB• 
The maximum number of permanent TEBs is the number specified in 
the MAXTIDS operand of the DFHTEPT TYPE-INITIAL macro 
instruction. 


TRMIDNT=name 

is used to provide the one— to four—character symbolic terminal 
identification for a permanently defined TE3• Only one 
terminal may be specified in each macro. 


D efine Error Status Elements — DFHTEPT TYPB=PERMCODEI ERRCODE 


The DFHTEPT TYPE=PERMCODE|ERRCODE macro instruction used to change the 
default threshold constants of the sample DFHTEP, and to define 
permanently reserved error status elements, is as follows: 


i-1-1-*-1 

I |DFHTEPT| TYPE={PERMCODE|ERRCODE} | 

| | I ,C0DE=[errcode|BUCKET} | 

| | | [,COUNT=number] 1 

| | | [ ,TIME= {number{,SEC),MIN |,HRS}) ] | 

i_i-1___i 
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TYPE={PERMCODB|ERRCODE} 

identifies whether the error code specified in the macro 
instruction is to have a permanently reserved or a dynamically 
assigned BSE. These macros are only required if no permanently 
reserved ESEs are to be defined, or if the sample DFHTEP 
default threshold constants are not to be overridden. These 
are listed in Figure 4.2—4 below. 

PERMCODE 

identifies the error code specified as having a permanently 
reserved ESE. Each permanently reserved ESE must be 
identified by a separate DFHTEPT TYPE=PERMCODE macro 
instruction. All DFHTEPT TYPE=PERMCODE macros must precede 
all DFHTEPT TYPE=ERRCODE macros. 

ERRCODE 

indicates that the error code specified does not require a 
permanently—reserved ESB, but that the sample DFHTEP 
default threshold constants are to be changed. Each error 
code requiring a threshold constant change, other than 
those defined as permanently—reserved, must be identified 
by a separate DFHTEPT TYPE=ERRCODE instruction. All 
DFHTEPT TYPE=ERRCODE macros must follow all DFHTEPT 
TYPE=PERMCODE macros. 


CODE= {errcode|BUCKET} 

identifies the error code referred to by the 

TYPE=PERHCODE|ERRCODE parameter. These codes are listed in the 
section "Format Description of TACLE DSECT." As an example the 
7770 timeout error condition would be entered as CODE=8A. 
CODE=BUCKET is only applicable to the DFHTEPT TYPE=ERRCODE 
macro instruction. It is used to override the default 
threshold constants established for the common error bucket. 


COUNT= number 

may be used in either the DFHTEPT TYPE=PERHCODE or TYPE=ERRCODE 
macro instruction to override the sample DFHTEP default 
threshold count limits (see Figure 4.2—4). When the number of 
occurrences of the error type specified reaches the threshold 
limit, an error processor would normally take a logic path that 
would cause DFHTACP default actions to be taken. If the number 
of occurrences is less than the threshold limit, the error 
processor would normally take a logic path that would override 
the DFHTACP default actions. The updating and testing of the 
current threshold counts are normally performed by a DFHTEP 
subroutine, which sets a condition code that the error 
processor can test to determine whether the limit has been 
reached. If the user specifies zero as the number in the COUNT 
operand, the threshold limit will never be indicated as having 
been reached. 
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TIHE=time options 

may toe used in either the DFHTEPT TYPE=PERHCODE or TYPE=ERRCOD£ 
macro instructions to override the sample DFHTEP default 
threshold time limits (see Figure 4,2-4). This parameter is 
only applicable when the OPTIONS=TIME parameter is specified in 
both the DFHTEPtt and DFHTEPT TYPE=INITIAL macro instructions. 
When the number of occurrences reaches the threshold limit 
specified in the COUNT=parameter (above) within the interval of 
time specified in this parameter, an error processor would 
normally take a logic path that would cause DFHTACP default 
actions to be taken. If the number of occurrences within the 
time interval is less than the threshold limit, the error 
processor would normally take a logic path that would override 
the DFHTACP default actions. If the time interval has expired, 
tne sample DFHTEP subroutine that normally updates and tests 
the current threshold count resets the occurrence counts and 
establishes a new expiration time. In this case the condition 
code set by the subroutine would indicate that the threshold 
limits had not been reached. Time control in the sample DFHTEP 
starts with the first occurrence of the error type. Subsequent 
occurrences of the same error type do not establish new 
starting times, but are merely accounted for as having occurred 
within the interval started with the first occurrence. This 
continues until an error count reaches the threshold limit 
within the interval started with the first occurrence, or until 
the interval has expired. In the latter case, the error being 
processed becomes a first occurrence, and a new interval is 
started. A time interval of zero means that the number of 
occurrences is to be accounted for and controlled without 
regard to a time interval. Zero is the implied time interval 
if the COUNT=parameter is zero or 1. It is also the implied 
time interval if the time options are not generated. 

The time interval may be expressed in any one of four units; 
hours, minutes, seconds, or hundredths of seconds. This allows 
the user to express fractional parts of a unit as whole units 
at a lower level. As an example, 1—1/2 minutes could be 
expressed as 90 seconds, or even 9000/100ths seconds. The 
maximum interval must be the equivalent of less than 24 hours. 
While the smallest interval that can be expressed is 1/100th 
second, a practical minimum would be 1 to 2 minutes. This 
allows for access method retries, plus the time required to 
create the task required to service each error. The four 
methods of expressing the threshold time interval are: 

number 

expresses the interval in 1/100th—second units. 

Parentheses are not required if this method is used. The 
maximum number must be less than 8,640,000 (24 hours). 

(number,SEC) 

expresses the interval in whole seconds and must be 
enclosed in parentheses. The maximum number must be less 
than 86,400 (24 hours). 

(number, MIN) 

expresses the interval in whole minutes, and must be 
enclosed in parentheses. The maximum number must be less 
than 1,440 (24 hours). 

(number, HRS) 

is used to express the interval in whole hours, and must be 
enclosed in parentheses. The maximum number must be less 
than 24 hours. 
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The following table illustrates the sample terminal error program 
default threshold count limits referred to in the TYPE, COUNT, and TIME 
operands of the DPHTEPT TYPE=PERMCODE |ERRCODE macro instruction. 


1- 

| CODE= 

| CO UNT= 

| TIME = 

| CODE= 

| C0UNT= 

| TIME= 


I 81 

1 3 

1 (7,BIN) 

1 91 

t o 

1 o 


| 84 

| 1 

1 o 

| 94 

| 7 

| (10,MIN)9 


1 35 

| 1 

1 o 

| 95^ 

1 o 

1 o 


| 86 

| 1 

1 o 

1 96 

1 2 

1 (1 ,MIN) 


1 

| 50^ 

1 o 

| 97^ 

1 o 

1 o 


| 88 

| 1 

1 o 

| 98 

| 5 

1 (5,MIN) 


| 89 

| 100^ 

1 (7,MIN) 

| 99 

| 1 

1 o 


| 3A 

1 2 

1 (2,MIN) 

| 9B 

| 1 

1 o 


| 8B** 

1 o 

1 o 

| 9C 

| 5 

1 o 


| 8C 

| 1 

1 o 

| 9D 

1 o 

1 (5,MIN) 



1 

1 

| 9E 

1 o 

1 o 


| 8D 

| 1 

1 0 

f 9F** 

1 o 

1 o 


| 8E 

| 1 

1 o 

| AO** 

1 o 

1 o 


| 8F 

| 1 

1 o 

| A1** 

| 5 

1 o 


| 90 

i_ 

1 o 

1 o 

| BUCKET 

| 5 

1 (5,MIN) 

. -» 


♦Error processor uses a threshold '•weight 11 instead of a threshold count 
(see sample DFHTEP source listing) . 

♦♦Error processor maintains error count only. DFHTACP default actions 
are always taken regardless of the threshold limits. 

♦♦♦For TCAM conditions without TACP defaults, TEP retries 5 times and 
releases TIOA. Otherwise the default TACP actions are taken. 

Figure 4.2—4. Sample DFHTEP Threshold Default Limits 

I N ote ; Threshold values are ignored for unit checks on local terminals 
| (error code X # 94 § ). 


Account for Specific Error Conditions — DFHTEPT TYPE=BUCKET 


The macro instruction used to cause specific error conditions to always 
be accounted for in the common error bucket is as follows: 


i-1-1- 

| IDFHTEPTI TYPE=BUCKET 

I I I ,CODE=errcode 

i-1-1- 



TYPE=BUCKET 

generates the macro to account for specific error conditions. 

| If MAXERR=25 (VSE) or 26 (OS/VS) is specified in the DFHTEPT 

TYPE=INITIAL macro instruction, this macro instruction is 
invalid. This macro is only required if no error codes are to 
be specifically accounted for in the common error bucket. Each 
error code must be specifically identified by a separate 
DFHTEPT TYPE=BUCKET macro instruction. 


CODE=errcode 

identifies the error code to be specifically accounted for in 
the common error Ducket. The error code must not be specified 
in the DFHTEPT TYPE=PERMCODE or TYPE=ERRCODE macro instruction. 
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Terminate DFHTEPT Macro — DFHTEPT TYPE=FINAL 


The DFHTEPT TYPE=FINAL macro instruction terminates the generation of 
the DFHTEP tables. 


|DFHTEPT| TYPE=FINAL 

.1_a_ 


DFHTEPT Macro Examples 


1. The following is an example of the minimum number of statements 
required to generate the TEP tables: 

DFHTEPT TYPE=INITIAL,MAXTIDS=10 

DFHTEPT TYPB=FINAL 

END 

This example generates ten reusable terminal error blocks, each 
capable of accounting for the maximum number of error types. Time 
••threshold 11 control is supported, and all "threshold 11 values are 
the defaults supported by the sample DFHTEP. 

2. The following is an example of a tailored TEP table: 


* TABLE SPECIFICATIONS 

DFHTEPT TYPE=INITIAL,MAXTIDS=10, * 

MAXERRS=5 

* PERMANENT TERMINAL DEFINITIONS 

DFHTEPT TYPE=PERMTID,TRMIDNT=TM02 

* PERMANENT ERROR CODE DEFINITIONS 

DFHTEPT TYPB=PERMC0DE,C0DE=81 

DFHTEPT TYPE=PERMCODE,CODB=87, * 

C0UNT=2,TIME=(1,MIN) 

* OTHER THRESHOLD OVERRIDES 

DFHTEPT TYPE=ERRCODE,CODE=BUCKET, * 

C0UNT=3,TIME= (3,MIN) 

* CONCLUDE TABLE GENERATION 

DFHTEPT TYPE=FINAL 

END 

This example generates ten terminal error blocks, one of which is 
reserved for the terminal whose symbolic identification is TM02, 
and the other nine being reusable. Each TEB has space for five 
error status elements plus a common error bucket. Of the five 
ESEs, two are reserved for error codes 81 and 87; the remaining 
ESEs are available to be assigned dynamically. The threshold 
limits for error code 87 and the common error bucket are being 
changed. No specific error code is to be accounted for in the 
common error bucket. 
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USER—WRITTEN TERMINAL ERROR PROGRAMS 


A user—written terminal error program may be generated. The user- 
written DFHTEP then replaces the dummy DFHTEP provided during in the 
DFHSG PROGRAM=CSO macro. The user—written DFHTEP will receive control 
as described at the start of this chapter, and therefore should use the 
TACLE as its basic interface with DFHTACP. 

Users of releases of CICS/VS prior to Version 1.1.1 should note that 
their existing terminal error programs may require modification to run 
on subsequent releases of CICS/VS. The TCTLEPTE field is now a full 
word direct pointer to the TCTTE of the terminal which produces the 
error. Previously, this was a halfword binary displacement which, when 
added to the true line entry address (TCTLEDCB), gave the correct TCTTE 
address. 

There are some situations in which CICS/VS may attempt to send a 
message to an input-only terminal; for example, an invalid transaction 
identification message, an ATP batch count, or a message erroneously 
sent by an application program. The user should provide a terminal 
error program to reroute these messages to a system destination such as 
CSMT or CSTL or other destinations by means of transient data or 
interval control facilities. 

A similar situation can exist when a message is sent to a 3735 
terminal operating as an input batch device. An attempt to write to the 
3735 before the receipt of the end of transmission (EOT) gives control 
to DFHTACP. If no DFHTEP is provided, the current transaction will 
abend and the line will be disconnected. 


ADDRESSING THE CONTENTS OF THE TACLE 


When DFHTEP receives control from DFHTACP, the TCA facility control 
address (TCAFCAAA) contains the address of a TACLE. The TACLE is 
created by the terminal control program when the error occurs and 
contains all the I/O error information provided by BTAM or TCAft. 

To address the contents of the TACLE, the user-written terminal error 
program should contain the statements "COPY DFHTACLE" and "COPY 
DFHTCTLE" in that order. These define the complete DFHTCTLE DSECT• The 
symbolic names in this DSECT are used to address fields in both tne 
TACLE and the real line entry associated with the error. 

The TACLE consists of a 16—byte prefix (defined by "COPY DFHTACLE") 
and a further 48—byte section, which is a modified copy of the DECB of 
the real line entry at the time the TACLE was created. 

To address the TACLE, the user-written terminal error program should 
contain the statements: 


COPY DFHTACLE and COPY DFHTCTLE 

L TCTLEAR,TCAFCAAA POINT TO TACLE 

USING DFHTCTLE,TCTLEAR 

Note that fields normally part of the real line entry DECB have 
offsets increased by 16 in the TACLE. 

The following fields in the DECB copy in the TACLE do not represent 
data copies from the real line entry: 
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TCTLEDCB (OS/VS) (Offset 24 in TACLE, 

I TCTLEDTP (VSB) 8 in real TCTLE) 

This field in the TACLE points to the real line entry, whereas in the 
| real line entry it points to the BTAM DCB (OS/VS) or DTP (VSE) for the 
line group. 


TCTLEECB+1 (Offsets 17, 18 in TACLE, 

TCTLEECB+2 1,2 in real TCTLE) 

These fields in the TACLE are used as interface bytes for the 
terminal abnormal condition program. 


TCTLECB+3 (Offset 19 in TACLE, 

3 in real TCTLE) 

This is used in the TACLE for BTAM return code on rejected I/O requests. 

TCTLECSW (Offsets 46, 48 in TACLE, 

TCTLBALP 30, 32 in real TCTLE) 

These are used in the TACLE for SAM error information, apart from their 
normal use for BTAM lines. 

Given addressability to the TACLE, the user may also address the real 
line entry (for example to inspect data not in the DECB copy) by coding; 


| L TCTLEAH,TCTLEDTP (VSB), or. 

L TCTLEAR,TCTLEDCD (OS/VS) 

USING DFHTCTLE + TCTLEECB,TCTLEAR 

Note: The real line entry storage definition starts at TCTLEECB, 16 

bytes after TCTLEPSA, and continues beyond the DECB end (TCTLESI)• 

To revert to addressing the TACLE, the user should recode: 


L TCTLEAR,TCAFCAAA POINT TO TACLE 

USING DFHTCTLE,TCTLEAR ADDRESS TACLE 

Extreme care should ne taken to ensure that the correct 
addressability is established when referencing fields in the DFHTCTLE 
DSECT. 

Note ; In programs that do not require a reference to the TACLE, the 
following statements give direct addressability to the real line entry: 

| COPY DFHTCTLE and COPY DFHTCTTE 

L TCTTEAR,TCAFCAAA POINT TO TCTTE 

L TCTLEAR,TCTTELEA POINT TO TCTLE 

USING DFHTCTLE,TCTLEAR ADDRESS TCTLE 

In this case the TACLE prefix is not mentioned and DSECT DFHTCTLE 
begins with field TCTLEECB. 

Once the user has performed the functions desired, and optionally 
altered the default actions scheduled by DFHTACP, the user—written 
DFHTEP must return control to DFHTACP by issuing the program control 
RETURN request. DFHTACP then performs the actions specified in the 
TACLE and causes the error processing task to terminate. 
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FORMAT DESCRIPTION OF TACLE DSECT 


TERMINAL ABNORMAL CONDITION LINE ENTRY 


Dec . 

0 

4 

8 

12 

16 

20 

24 


I 


28 


44 


48 


60 


r 

4c 


Hex.* <- 4 BYTES->* 

* * 

q ***************************************************** 

♦ TCTLBPSA * 

* * 

♦ STORAGE ACCOUNTING AREA * 

4 *---* 

♦ TCTLEPCH * 

♦ * 


8 


C 


10 


14 


18 


1C 


* ADDRESS OF TRANSIENT DATA OUTPUT AREA 

* - 

* TCTLEPFL * TCTLEPF2 * 

* * * NOT USED 

* ERROR FLAGS * SPECIAL IND * 

* - 

* TCTLEPTE 

* 

* TCTTE ADDRESS 

* - 


♦ 

-4c 

* 

♦ 

4t 

J* 

* 

* 

4c 

-4c 


* TCTLEECB * * * BTAB/TCAH 4c 

* BEGINNING * ACTION *RESERYED * RETURN * 

* OF DECB * FLAGS *FOR DFHTACP* CODE * 

* --- * 


* 


4c 


* 


♦ 


* 4c 

* - * 

* TCTLEDCB (OS/VS only) * 

* or TCTLEDTF (VSE only) * 

* ACTUAL LINE ENTRY ADDRESS * 

* - * 


4c ♦ 

* * 


2C 


30 


3C 


4c 

* - 

* 

* NOT USED 

4c 

* - 


4c 

- * 

* TCTLECSW * 

4c * 

* BSAM STATUS * 

- * 


* TCTLBALP * * 

* BSAM * * 

* SENSE * * 

* ---4c 

4c 4c 

* TCTLEOA * 

* * 


***************************************************** 
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Displacement 


Dec, Hex, Code 

0 0 

4 4 


8 8 

81 

83 

84 

85 

86 

87 

88 
89 
8A 
8B 
8C 
8D 
8E 
8F 

| 90 

I 

I 91 

I 

94 

95 

96 

97 

98 

99 
9B 
9C 
9D 
9E 

9F 
AO 
A1 


Bvtes Label 


Meaning 


4 TCTLEPSA 

4 TCTLEPCH 


1 TCTLEPFL 

TCEMCAAR 


Storage accounting 
Pointer to 100 bytes of user 
storage that can be used to 
write to transient data 
(first 8 bytes reserved for 
storage accounting), 

This storage must not be 
freed by DFHTEP, as DFHTACP 
may reuse it. 

Error flags 

Message too long 

2740—2 auto output request 

TCT search error 

Invalid write 

Polling list error 

Unsolicited input 

Input event rejected 

Status message received 

7770 32—second timeout 

Hardware buffer exceeded 

Output event rejected 

Output length of zero 

No output area 

Output area exceeded 

Print gueued (after unavailable 

printer) 

IC error (after unavailable 
printer) 

Unit check 

Unit check (should not occur) 

Unit exception 

Unit exception (should not occur) 
Negative response 
Undetermined I/O error 
Copy error (3270) 

Invalid message block 
Incomplete message 
No printer available for 
3270 print request 
Invalid destination (TCAM) 

Invalid read 
Invalid disconnect 





• 

• 

(All codes 

not listed 

are reserved) 


9 

9 


1 

TCTLEPF2 

Special indicator 




01 



dummy terminal 

1 

12 

C 


4 

TCTLEPTE 

Address of terminal entry 

1 






for terminal in error 

1 

16 

10 


44 

TCTLEECB 

DECB/copy of line when 

1 






error occurred 


60 

3C 


4 

TCTLEOA 

For TCAM lines only. 


Address of the line 
I/O area containing 
the input or output message, 
or zero if none available 
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TACLE ACTION AND INFORMATION BITS 


The following definition of the DECB area includes TCTLEECB+1 which 
contains the action bits (0, 3, 4, 5, 6, and 7) and information bits (1 
and 2). This is the only portion of the copy of the DECB that can be 
altered. These bits are located at label TCTLEECB+1• 


Dec. 

Hex. 


Bytes 

Label 

Meaning 

17 

11 


1 

TCTLEECB+1 

Interface byte 



Bit 0 


0... .... 

Place line in service 





1 ... .... 

Place line out of service 



Bit 1 


.0*. .... 

Information bit 

Not used 





. 1 . . .... 

Nonpurgeable task exists 
on terminal 



Bit 2 


..0. .... 

Information Bit 

Not used 





..1. .... 

Switched line has been 
disconnected by BTAM 



Bit 3 


...0 .... 

Do not disconnect line 





...1 .... 

Disconnect line 



Bit 4 


.... 0... 

Place terminal in service 





.... 1... 

Place terminal out of service 



Bit 5 


.... .0.. 

Do not abend task 





.... .1.. 

abend task 



Bit 6 


.... ..0. 

Leave terminal's associated 
control unit on poll list 





.... ..1. 

Take terminal's associated 
control unit off poll list 



Bit 7 


.o 

Do not abort WRITE or 
free terminal storage 






on task abend, or no task 
present on terminal 





.... ...1 

Abort terminal WRITE 






requests and free terminal 
storage on task abend or 
no task present on terminal 

18 

12 


1 

TCTLEECB+2 

Interface byte 2 



Bit 0 


1... .... 

Release TCAM incoming message 



Bits 1—7 



Reserved 

19 

13 


1 

TCTLEECB+3 

BTAM return code 

24 

18 


4 

TCTLEDCB 
(OS/VS) or 

Actual line entry address 





TCTLEDTF (VSE) 

46 

2E 


2 

TCTLECSW 

BSAM status 

48 

30 


1 

TCTLBALP 

BSAM sense 


The following factors should be considered when altering the action 
bits in the TACLE: 

• For TCAM unsolicited input errors with either the terminal out of 
service or in receive—only state , a loop will occur if the default 
action of purging the incoming message does not occur and the 
status of the terminal is not altered. 
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The dummy terminal indicator at TCTLEPF2 is set on errors such as: 
(1) BTAM return on input, (2) binary synchronous outputs performed 
for TCP where no terminal is indicated, and (3) other errors from 
which no specific terminal is indicated. Therefore, if dummy 
terminal is indicated, task abend and write abort are not set (see 
below). The dummy terminal is only used to identify the line. 

The “switched line disconnected 11 bit (X^O 1 at TCTLEECB+1) is used 
by DFHTACP upon return from DFETEP to logically disconnect (by 
issuing a WHITE BREAK) the switched line that has been physically 
disconnected by BTAM • If DFHTEP determines that the line has not 
been physically disconnected, DFHTEP may reset this bit. DFHTCP 
can communicate this disconnect condition for BISYNC lines to 
DFHTACP by setting the bit TCBSWB in the field TCTLEDI in the real 
line entry. DFHTCP will do this when a READ INITIAL or HEAD 
CONNECT completes with an I/O error or when a mandatory disconnect 
seguence (DLE—EOT) is received from the remote terminal. OS/VS 
BTAM may DISABLE a switched line and convey this fact by setting 
the bit X^OB 1 in the field TCTLEES. This flag may be tested in the 
TACLE. 

The “disconnect switched line“ bit (XMO 1 at TCTLEECB+1) is used by 
DFHTEP to request that DFHTACP actually makes the disconnection (by 
means of a WRITE DISCONNECT). 

If the “switched line disconnected” bit or the "disconnect switched 
line” bit is on, upon return from DFHTEP, the “task abend” bit 
should also be set to purge the task from the disconnected 
terminal. If this is the case and if the task is not purgeable 
from the terminal, DFHTACP writes an INTERCEPT REQUIRED message to 
destination CSMT and places the terminal out of service. 

The “abend transaction” bit (X i 04 t in TCTLEECB+1) is always 
associated with two other bits as part of TACP action 3. These 
other bits are "non—purgeable task" and "write abort" (X , 40* and 
X *01 • respectively, both in TCTLEECB+1). 

“Write abort” is always set on at the same time as "abend 
transaction”. It has the effect of clearing the TCTTE of the 
original write request indicators, if the error being processed 
occurred on a TC WRITE. 

“Non-purgeable task” is set on if a transaction is currently 
associated with the terminal, but if this transaction ID was 
specified with TPURGE=N0 in the PCT. 

None of “abend task”, "Write abort", or “non-purgeable task” bits 
will be set if the dummy terminal indicator is on, even if DFHTACP 
would normally set default action 3 (abend transaction) for the 
error being processed. The following remarks only apply, 
therefore, to errors related to a real terminal. 

"Abend task" has no effect if no transaction is associated with the 
terminal. Otherwise, if “non-purgeable task” is indicated, the 
transaction remains attached to the terminal (normally in SUSPEND 
state) and DFHTACP writes the DFH2522 INTERCEPT REQUIRED message to 
CSMT; if the transaction is not marked "non-purgeable”, it is 
abended with code ATAI, or rarely, ATAD. 

"Write abort" has no effect if the TCTTE was associated with a READ 
request. In this case the normal result will be that, if the line 
and terminal remain in service, the read will be retried. 
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EXAMPLE OF A USER-WRITTEN TERMINAL ERROR PROGRAM 


Following is an example of the steps of logic necessary to design a 
portion of the terminal error program, and has been called the "DFHTEP 
Recursive Retry Routine 11 . In this example ten retries are provided for 
each terminal; however, the logic could be used for any number of 
retries. The following assumptions are made: 

USER FIELD A 
(PCISAVE) 

Represents a six—byte field in the process control 
information (PCI) area of the TCTTE (see the TCT macro 
definition of the TCTUAL operand). This field is used to 
preserve the count of input and output from the TCTTE when 
the first error occurs. These .counts are contained in 
three—byte fields located at TCTTENI and TCTTENO within the 
TCTTE• 


USER FIELD B 
(PCICNT) 

Represents a user—defined field used to accumulate the 
count of recursive errors. It would most likely be in the 
process control information (PCI) area of the TCTTE. 


SYSTEM COUNT 
(TCTTE NI) 

Represents the six—byte field in the TCTTE that contains 
the terminal input and output counts (TCTTENI+TCTTENO). In 
the example, these two adjacent fields are considered as 
one six—byte field. 

Because this example requires access to the TCT terminal entry 
(TCTTE) to examine the SYSTEM COUNT and to also locate the process 
control information (PCI) area, the DFHTCTTE symbolic storage definition 
is included so that fields may be symbolically referenced. 
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DFHTBP fiecursiye Retry Routine 


************************************************************************ 
* * 

* DFHTEP RECURSIVE RETRY ROUTINE * 

* * 

************************************************************************ 
TEPBAR EQU 2 TEP PROGRAM BASE 


TCTTEAR EQU 9 


PCIBAR 

EQU 

8 


DFHTCA 


COPY 

EJECT 

DFHTCTTE 


COPY 

DFHTACLE 


COPY 

EJECT 

DFHTCTLE 

PCIAREA 

DSBCT 


PCISAVE 

DS 

6X 

PCICNT 

DS 

EJECT 

PL2 

DFHTEP 

CSECT 



BALE 

TEPBAR,0 


USING 

*,TEPBAR 


L 

TCTLEAR,TCAFCAAA 


L 

TCTTEAR,TCTLEPTE 

* 


L 

PCIBAR,TCTTECIA 


USING 

PCIAREA,PCIBAR 


TM 

PCICNT+1,X *0C 1 

* 

* 


BO 

CKCOUNT 

* 

* 

RESET 

MVC 

PCICNT,=PL2»+0* 

* 


MVC 

PCISAVE (6) ,TCTTENI 

* 

* 

INCR 

AP 

PCICNT,=P■1• 

* 

* 


CP 

PCICNT,=P*10* 

* 


BNE 

RETRY 

* 


ZAP 

PCICNT,=P*0» 


MVC 

PCISAVE (6) ,TCTTENI 


B 

NOBETKT 

CKCOUNT 

CLC 

PCISAVE (6),TCTTBNI 

* 


BNE 

RESET 


* 

♦ 

* 


B INCR 

* 

* 

♦ 

RETRY DS OH 
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BASE REGISTER FOR TCTTE 
BASE FOR PCI 
TASK CONTROL AREA 
COPY TCTTE DEFINITION 

COPY TACLE SYMBOLIC DEFINITIONS 
COPY DECB DEFINITION 


USER FIELD A 
USER FIELD B 


ESTABLISH PROGRAM ADDRESSABILITY 

LOAD TACLE ADDRESS 
LOAD TCTTE BASE WITH 
TCTTE ADDRESS 
LOAD PCI AREA ADDRESS 
ESTABLISH ADDRESSABILITY 
HAS USER FIELD B EVER BEEN 
INITIALIZED TO A PACKED 
DECIMAL NUMBER? 

.. YES, SO COMPARE THE 
SYSTEM COUNT WITH THE 
EXISTING COUNT IN FIELD B; 

. . NO, SO INITIALIZE FIELD 
B TO A PACKED DECIMAL 0. 

SAVE THE CURRENT SYSTEM 
COUNTS. THIS IS A NEW 
ERROR, OR FIRST TIME THROUGH 
INCREMENT THE NUMBER OF 
TIMES THIS SAME ERROR HAS 
OCCURRED. (RECURSIVE COUNT) 

HAS THE MAXIMUM RECURSIVE 
ERROR LIMIT BEEN REACHED? 

.. NO, SET ACTION 
INDICATORS FOR RETRY ATTEMPT 

* CLEAR AND RESET USER FIELDS 

♦ FOR NEXT ERROR SET 

ACTION INDICATORS FOR NO—RETRY. 
HAS SYSTEM COUNT CHANGED SINCE 
LAST ENTRY TO TEP? 

.. YES; THAT MEANS THIS IS 
A NEW ERROR SINCE SOME I/O 
ACTIVITY HAS OCCURRED ON 
TERMINAL 

.. NO; THAT MEANS THIS IS A 
RECURSIVE ERROR, SO 
INCREMENT THE RECURSIVE COUNT 
AND CHECK FOR RETRY. 

THE USER WOULD INCLUDE HERE 
THE CODE NECESSARY TO ALTER 
THE FLAGS IN THE TACLE SO 
THAT A RETRY CAN BE PERFORMED 
ON THE TERMINAL. 
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NOBETBY DS 


OH 


LTOBG 

END 


THE USES WOULD INCLUDE HEBE 
THE CODE NECESSABY TO ALLOW 
DFHTACP TO TAKE FINAL ACTION 
ON THE TERMINAL (I.E., ABEND 
TASK, PUT LINE OUT OF SERVICE, 
ETC.) 


The above example is intended only to serve as an illustration of a 
recursive error handling technique and the steps necessary to establish 
addressability to the applicable control blocks. 

Note: To prevent data security violation (for example, when a terminal 
has been put out of service and the operator leaves that terminal, the 
master terminal may put that terminal back into service and another 
operator may use the terminal with the original operator*s security 
key), the following code may be included in the DFHTEP (for example, 
after the label ••NOBETBY” in the example above) to provide an automatic 
sign—off: 

L 11,TCTLEPTE 

DFHPC TYPE=LINK,PROGRAK=DFBSFP 

After providing addressability to every terminal entry, similar 
actions may be performed for every terminal on a line that is taken out 
of service. 


DFHTEP ALTEBNATE INTERFACE (CICS/OS/VS ONLY) 


An alternate interface is provided in CICS/OS/VS to maintain 
compatibility with the CICS/OS—STANDARD Version 1 user who currently has 
code dependent upon this interface. This interface is provided when the 
user specifies V1CMPAT=YES in the DFBSG TYPB=CSO macro instruction 
during system generation. 

When an error is detected, control is passed to DFHTEP for analysis; 
the TWA contains the following information: 


BYTES 

LABEL 

DEFINITION 


1 

THACOBA 

Contains 

the 

status byte from BTAM 

1 

TWACOBA+1 

Contains 

the 

sense byte from BTAH 

1 

TWACOBA+2 

Contains 

issued 

the 

teleprocessing OP code being 

1 

THACOBA+3 

Reserved 



4 

TWACOBA+4 

Contains the transaction identification, 
if one exists, for the terminal in error 

The 

user—written DFHTEP 

must place 

the 

line or terminal in service. 


or out of service if so desired. If the task is to be abnormally 
terminated, DFHTEP must place a X I FE I at label TWACOBA before returning 
control to DFHTACP. 


Chapter 4.2. The Terminal Error Program 


395 



USER-WRITTEN ACTIONS FOR PARTICULAR CASES 


This section provides guidance on how to write a user—written terminal 
error program to handle error conditions from several devices. The 
following topics are discussed: 

• Switched BSC temporary text delay (TTD) 

• 7770 32—second timeout 

• 2740 model 2 

• Teletypewriter (WTC only) 

• 3270 unavailable printer 

• 3600 BSC 

• 3275 dialed timeouts 

• 3270 locked buffer 


S witched BSC Temporary Text Delay (TTD) 


When a temporary text delay indication is received, BTAM, after retrying 
the operation up to seven times, will turn on TCTLESF7 (TCTLESF=X• 01 1 ) 
and return control to CICS/VS indicating that an error has occurred. 
CICS/VS will then invoke DFHTEP for error analysis. 

BTAM may also turn on TCTLESF7 when a data record ending with ENQ is 
received (the terminal detected a parity or transparency error). 
Therefore, DFHTEP should also examine the I/O area pointed to by 
TCTLEIOA to determine if it contains STX ETX (TTD) or EOT ...data... 

ENQ. 


7770 32-second Timeout 


If a terminal connected to the 7770 Audio Response Unit goes "on hook* 1 
while no I/O operation is outstanding, the 7770 does not present the 
unit exception to the channel. This situation can occur when the 
terminal operator makes an inquiry and hangs up before receiving a 
response. After this occurs, all writes to the line appear to complete 
normally. All reads complete normally at the end of the 32—second 
timeout with a zero data length. 

When a 32—second timeout occurs, either the terminal operator has not 
entered anything for 32 seconds, or the terminal operator has hung up 
and the 7770 did not inform CICS/VS. CICS/VS cannot distinguish between 
these two conditions; therefore, CICS/VS handles every 32-second timeout 
as an error condition. DFHTACP goes to DFHTEP with defaults of 
DISCONNECT SWITCHED LINE and ABEND THE TRANSACTION. If DFHTEP does not 
disconnect the switched line, CICS/VS writes the ••ready” message and 
initiates another read. 
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2740 Model 2 


Whan DFHTACP detects a negative response from a 2740 Model 2, the write 
operation will be retried after a ten second time delay if the user- 
written TEP has been coded to retry the write. This delay allows for 
operator reaction time etc. If the delay time factor is to be changed, 
this may be done by storing the new time delay factor at TCTTEBC• The 
value is a positive binary number representing hundredths of a second 
(ten seconds would have a value of FMOOO 1 or X^OOOOBEB 1 ) which is 
calculated by adding the delay value to the value contained in CSACSCC. 
The cause of the negative response may be determined by examining the 
field TCTLERSP. The contents of TCTLERSP and the meaning of each 
follow: 

X*04 ■ Terminal in bid mode 
X•02• Terminal in communicate mode 

X* 20• Terminal in communicate mode with document device down 
X*10 # Terminal in local mode 

X*13 1 Terminal in communicate mode but out of paper 
X 1 08• Contents of buffer are being printed 

Caution: Failure to set a long enough time delay may cause a loop at 

the terminal and pressing the reset key will not be recognized. 


T eletypewrite r_(WTC only ) 


There are no default actions provided by DFHTEP for the Teletypewriter 
(WTC only). All exceptional conditions have to be handled by the user. 
In the case of an ID error or a severe transmission error, he may want 
to abend the task and disconnect the line so that the computer is able 
to accept a new connection. Under these circumstances it is recommended 
that after entry to DFHTEP, the interface byte for the status of the 
task, line, and terminal, (that is, TCTLEECB+1) be set to the following 
values before returning to DFHTACP: 

Bits 01234567 

Values 0 line in service 

* unchanged 

0 switched line disconnect 

request "off" 

1 disconnect line 

0 terminal in service 

1 abend task 

* unchanged 

* unchanged 
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3270 Unavailable Printer 


This condition arises when a print request is made through the 3270 
print request facility and there are no printers on the control unit or 
the printer (s) is in one of the following conditions: 

• Out of service 

• A task is presently attached 

• Currently busy on a previous operation 

• Intervention required 

The terminal control program recognizes this condition and issues a 
READ BUFFER operation to collect tne data into a line I/O area. The 
LIOA is of the same format as a TIOA would be if an application program 
had issued a terminal control read buffer request; thus, the TIOA DSECT 
may be used to reference the LIOA. 

The TCP then obtains a TACLE and attaches DFHTACP with the error code 
X^E* (TCEMCUP) • The TACLE fields relevant to this situation are: 


TCTLEIOA - Pointer to the LIOA 

TCTLETLA—1 - Pointer to first printer on control unit or 

zero (no printers) 

DFHTACP writes the DFH2508 UNAVAILABLE PRINTER message to the CSMT 
destination and LINKS to DFHTEP with no default actions set. 

On return from DFHTEP, DFHTACP will perform the following actions, 
based on the field TCTLETLA in the TACLE: 

1. If TCTLETLA—1 is all FFs (-1 set by DFHTEP) DFHTACP assumes that 
DFHTEP has disposed of the data to be printed and desires the 
keyboard of the originating terminal to be restored. 

2. If TCTLETLA—1 is 0 (zero) DFHTACP will assume that no printer is 
available, and the keyboard of the originating terminal will not be 
restored. 

3. If TCTLETLA—1 is neither 0 (zero) nor —1 (all FFs) DFHTACP assumes 
that TCTLETLA—1 is the address of a printer. An interval control 
PUT will be performed to the provided terminal. The transaction to 
be initiated is CSPP (print program), and the time interval will be 
zero. If CSSP is to be scheduled, AUTOTRN=YBS must be specified in 
DFHSG PROGRAM=TCP to include the AVAIL logic. 

a. If an error occurs on the interval control PUT, DFHTACP will 
write the DFH2531 IC FAILURE message to the destination CSTL 
| (DFHTACP error code X*91»). DFHTACP will then link to TEP 

again with the high order bit (X*80 a ) set in the TACLE field, 
TCTLETLA—1, ana the IC error value from the TCA field TCAICTR 
is placed into the TACLE field, TCTLEBCB+3• This is done in 
order for TEP to have a last chance to dispose of the data. On 
the second RETURN from TEP to DFHTACP, DFHTACP will reexamine 
TCTLETLA—1• If TCTLETLA—1 is -1 (all FFs), DFHTACP will 
restore the keyboard of the originating terminal, otherwise, 
the keyboard will remain locked. 
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b. If no error occurred on the interval control PUT, DFHTACP will 
check for the following printer conditions: 

(1) Out of service 

(2) Intervention required 

(3) Other than RECEIVE or TRANSCEIFB status 

If one of these conditions is true, DFHTACP will issue the 
| DFH2532 PRINT QUEUED message to the destination CSMT 

| (DFHTACP error code X^O 1 ). 

4. DFHTACP will then terminate any PRINT requests on the originating 
terminal, free the LIOA, and perform normal action flag processing 
on the originating terminal. 

Note that all scheduling and error handling for 3270 printers 
operating under TCAM is provided by the message handler. 


3600 BSC 


There is no special default processing provided in DFHTEP for BTAH— 
supported 3600 BSC terminals. 


I 3 275 Dialed Timeouts 

I 

| CICS/VS will always disconnect a 3275 switched line if there is no 
| activity on the line for two minutes. 

In some countries, a legal requirement exists that prohibits a 
switched line from remaining connected for more than 30 seconds if no 
line activity is taking place. This action is initiated by the modem 
(for example, WTC 3976—3) dropping DSR and going on hook. In this 
situation, CICS/VS will disconnect the line and manual intervention may 
be required to reestablish the connection. 


3270 Locked Buffer 


To prevent data displayed on a 3270 display from being copied to a 3270 
printer, the "from" buffer can be locked by placing a protected 
alphanumeric attribute byte (BIT2=1, BIT3=0) in address 0. This will 
cause any attempted copy command to end with sense status X , C4C1 # . For 
further information, refer to the 3270 Information Display System 
Co mponent Description Manual . 
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Chapter 4.3. The Node Error Program 


As with the terminal error program for non—VTAM devices, the node error 
program for logical units is available in two forms; the CICS/VS— 
supplied sample node error program, and the user—written version (s). 
Both types are discussed in the following sections. 

| Note: Node error programs, not terminal error programs, must be used 
| for terminals and logical units supported via the ACF/VTAM interface. 


WHEN AN ABNORMAL CONDITION OCCURS 


The following CICS/VS components are involved when an abnormal condition 
is detected from a logical unit: 

| • The terminal control program VTAM portion — DFHZCA, DFHZCB, 

| DFHZCP, DFHZCX, DFHZCY, and DFHZCZ. 

• The node abnormal condition program — DFHZNAC. 

• The CICS/VS—supplied sample node error program, or the user—written 
version (s) of that program (DFHZNEP) • 

The implementation of error—processing for logical units is such that 
any error detected by the VTAM portion of the terminal control program 
is routed to the node abnormal condition program (DFHZNAC). The node 
abnormal condition program issues messages and sets flags appropriate to 
the kind of error that has occurred, and passes control to the 
appropriate node error program (DFHZNEP) . After taking whatever action 
is necessary, the node error program returns control to the node 
abnormal condition program via a program control RETURN operation. 

For further details on node error programs, refer to Appendix E for a 
list of the error conditions and appropriate node abnormal condition 
| program action flag settings, and to Chapter 5.2 of this manual. Note 
| that when the dynamic close of the VTAM ACB facility is used, CICS/VS 
j can still be operational even though the link with VTAM may be broken. 


THE SAMPLE NODE ERROR PROGRAM 


The CICS/VS sample node error program is a generalized program structure 
for handling errors detected from logical units. None of its components 
are generated as part of the standard CICS/VS generation process, but 
instead may be optionally generated as described in this section. 

The sample node error program provides a general environment for the 
execution of error processing routines (error processors) each of which 
is specific to certain error codes generated by the node abnormal 
condition program. Optional error processors, sufficient for normal 
operation of VTAM 3270 or interactive logical unit networks, are 
provided; these can be easily supplemented or replaced by user—supplied 
processors. 
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The type of errors that may occur in a VTAM network are threefold: 

• Errors in the host system. 

• Communication errors, such as session failures. 

• Abnormal conditions at the terminal, such as intervention required 
and invalid requests. 

A sample node error program is supplied with CICS/VS, which may be 
used as the basis of each subsequent user—written node error program. 
This provides the user with: 

• A general environment within which user—written error processing 
programs may be easily added. 

• Fundamental error recovery actions for a VTAM 3270 network which 
are consistent with those provided in the sample terminal error 
program for a BTAM 3270 network. 

• The default node error program in a system that has several node 
error programs. 

The CICS/VS—supplied sample node error program is described in 
greater detail below. 


COMPATIBILITY WITH THE SAMPLE TERMINAL ERROR PROGRAM 


The default error processors for VTAM 3270s in the sample node error 
program provide facilities for error handling similar to those for BTAM 
3270s that are processed by the sample terminal error program. 

Receipt of sense/status corresponds to error codes X*D9 # , X , DC B / and 
X 1 DD*• Weighted counts of these messages are maintained against numeric 
and time thresholds. If the numeric threshold is exceeded, default 
actions are taken. If the time threshold is reached, the count is 
reset. This is equivalent to the function in the sample TEP, except 
that sense/status arising out of the "from 11 device on a COPY command is 
now presented to the node error program as an error on the "to” device, 
thus exceeding the threshold, which causes the request to be terminated, 
although the terminal remains in service. Some of the weights for 
errors that occur on the 3270 display have been revised, otherwise the 
weight and threshold values are the same as the defaults used in the 
sample TEP. Time threshold maintenance is mandatory and not optional as 
in the sample TEP. 

For further on time and threshold count limits, refer to the 
information on the sample terminal error program in Chapter 4.2. 

3270 "unavailable printer” corresponds to error code X , 42 l (interval 
control PUT request has failed). The algorithm used for printer 
selection differs in VTAM support; the retry algorithm in the sample 
node error program is appropriate to this new selection algorithm. 
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COMPONENTS 


The sample node error program comprises the following components: 

• The Routing Mechanism 

• The Node Error Table 

• Optional Common Subroutines 

• Optional Error Processors for 3270 or Optional Error Processor for 
interactive logical units. A node error program cannot be 
generated with both 3270 and interactive logical unit error 
processors. 

The components are described below. 


Routing Mechanism 


The routing mechanism invokes the appropriate error processor depending 
on the node abnormal condition program error code. 

Groups of one or more error codes are defined in the DFHSNEP macro 
(see below). Each group is associated with an index (in the range X*01 i 
through X^F*) and an error processor. A translate table is generated 
and the group index is placed at the appropriate offset for each error 
code. Error codes not defined in groups have a zero value in the table. 
An error processor vector table (EPVT) contains the addresses of the 
error group processors, positioned according to their indexes. The 
vector table extends up to the maximum index defined; undefined 
intermediate values are represented by zero addresses. 

On entry to the sample node error program, initialization establishes 
addressability to the node error table (NET) and, if included, the 
common subroutine vector table (CSVT). The error code is translated to 
obtain the error group index. A zero value causes the node error 
program to take no further action, otherwise the index is used to obtain 
the address of the appropriate error processor from the EPVT. A zero 
address causes the node error program to take no further action, 
otherwise a call is made to the error processor. This is entered with 
direct addressability to the following areas: NET, TCTTE, TCA, CSA, and 
CSVT. After execution of the error processor, the node error program 
returns control to the node abnormal condition program. 


Node Error Table 


The node error program may use a node error table (NET) which comprises 
node error blocks (NEBs) that are used to maintain error status 
information for individual nodes (see Figure 4.3—1). Some or all of the 
NEBs may be permanently reserved for specific nodes, others are 
dynamically assigned to nodes when errors occur. The latter are used 
exclusively for the nodes to which they are assigned until they are 
explicitly released. All the NEBs have an identical structure of error 
status blocks (ESBs). Each ESB is reserved for one error processor and 
associated with it by means of the appropriate error group index. The 
ESB length and format may be tailored to the particular error processor 
that it serves. 
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NET 


NEB 


i-» 

| NODE ERROR | 
| TABLE HEADER | 


NODE ERROR 
BLOCK 


i-1 


PERMANENTLY- 

ASSIGNED 

NEBs 


J 


( DYNAMICALLY- 
ASSIGNED 
NEBS 


| NODE ERROR | 
| BLOCK HEADER | 


ERROR STATUS 
BLOCK 


i_i 


ESBs 


Figure 4.3—1. Format of Node Error Table and Node Error Block 


Optional Common Subroutines 


The common subroutines are addressed via the CSVT and provide error 
processors with the following functions: 

1. Locate or assign NEBs and ES3s on the basis of node identification 
and error group index. 

2. Timestamp an error, update an error count/ and test an error count 
against numeric and time threshold values. 

3. Release a dynamically—assigned NEB from a particular node. 


Optional Error Processors for 3270 Logical Units 


Two error processors are supplied as follows: 

• Group index , error codes X f D9 B / X , DC , # and X B DD B . 

These error codes correspond to the receipt of sense/status bytes 
in the user sense fields of the RPL. The error processor locates 
an ESB of the standard format and updates a weighted error count. 
The weight, threshold/ and timer values are based on those used by 
the sample terminal error program for a 3TAM 3270 except as noted 
in the previous section. If the threshold is not exceeded/ the 
"abort send"/ "abort receive"/ "abend transaction" bits # and all 
the print action flags are turned off. Otherwise the default 
actions are taken and the NEB released if reusable. 

• Group index 2 , error code X , 42*. 

This code means that no 3270 printer was available to satisfy a 
PRINT request made at a 3270 screen. The error processor examines 
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the printers defined for this screen to determine why they were 
unavailable. If either is busy on a previous PRINT or COPY request 
(that is, a task is attached with transaction identification of 
CSPP or CSCY) or is no longer unavailable, that printer address is 
returned to the node abnormal condition program which will retry 
the PRINT request with an IC PUT command. Otherwise the default 
actions are taken. (For more details see the section ”3270 
Unavailable Printer 11 later in this chapter.) 


Optional Error Processor for Interactive Logical Units 


• Group index 1, error codes X t DC i . 

This error code, in combination with a user sense value of X^BIB", 
indicates a "receiver in transmit mode” condition. The action 
flags are manipulated in order to allow retry of the failing SEND 
request. 


GENERATING THE SAMPLE NODE ERROR PROGRAM 


The routing mechanism, common subroutines, IBM-supplied error 
processors, and user-supplied error processors are generated by means of 
DFHSNEP macros. 

| The sample node error program is added to the system in the same way 
| as system tables, using the cataloged procedure DFHAUPLK and ignoring 
| the SMP errors. Refer to the appropriate CICS/VS System Programmer "s 
I Guide for further details on assembling and link—editing CICS/VS system 
j tables. When using the sample node error program, the CSNE TWA size 
supplied by CICS/VS will be adequate. 

Note that an extra 24 bytes are required for the common subroutines 
register save area, and further space is required for the error 
processor save area. The CICS/VS sample processors use 4 bytes of this 
area. 

The DFHSNEP macro to generate the sample node error program has four 
types, as follows: 

TYPE=INITIAL 

to generate the routing mechanism and, optionally, the common 
subroutines. 

TYPE=DEF3270 

to generate the default IBM—supplied error processors for 32 70 
devices. 

TYPE=DEFILU 

to generate the default IBM—supplied error processor for 
interactive logical units operating in contention mode. 

TYPE=FINAL 

to indicate the end of the sample node error program. 

The order of these macros is constrained so that there is one 
TYPE=INITIAL which appears first, and one TYPE=FINAL and which appears 
last. 
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TYPE=DEF3270 

specifies that the IBM-supplied error processors for 3270 
logical units are to be included in the node error program. 
This macro causes the following source code to be generated: 

DFHSNEP TYPE=ERRPE0C,GR0UP=1,C0DE= (D9 , DC r DD) 
sense/status error processor code 

DFHSNEP TYPE=ERRPR0C,GR0UP=2,C0DE=42 

unavailable printer error processor code 
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Error Processors for IMTLO — DFHSHEP TYPB=DBFILP 


The DFHSNEP TYPE=DEFILO macro nas the following format: 


I 

L 


I I 

IDFHSNEP| TYPB=DEFILU 


I-L 



TYPE=DEFILU 

specifies that the IBH—supplied error processor for interactive 
logical units is to be included in the node error program. 

This macro causes the following source code to be generated: 

DFHSNEP TYPE=BfiRPROC,GROUP=1,CODE=DC 

receiver in transmit mode error processor code 


Terminate DFHSNEP Entries — DFHSNEP TYPB^FINAL 


The DFHSNEP TYPE=FINAL macro has the following format: 


r 

I 


L. 


I-1- 

|DFHSNEP| TYPE=FINAL 


L 


L 


1 

I 


J 


TYPE=FINAL 

indicates the end of the node error program and causes the 
error processor vector table (BPVT) to be generated. 


Generate the Sample Node Error Table — DFHSNET 


| The DFHSNET macro is used to generate a node error table. An entry for 
| each sample node error table generated must be included in the PPT. 



i-r 

|DFHSNET| 

c NAME=name] 

-1 


i i 

[ ,COUNT=threshold] 



t i 

[,ESBS=(index,length,...) ] 



i i 

[ ,NEBNAHE= (name,...) ] 



i i 

[,NEBS=number] 


1_ 

i i 

1_L. 

[,TIHE=(interval,units) ] 

_ » 


NAME=name 

specifies the identifier to be included in the NET header. It 
must be a string of one through eight characters. This operand 
is optional and defaults to DFHSNET. 


COUNT=threshold 

specifies the error count threshold that is to be stored in the 
NET header for use by the common subroutines to update standard 
ESBs. If the threshold is exceeded, the error processor that 
invoiced the subroutine is informed by a return code. The 
maximum value is 32767. This operand is optional and defaults 
to 100. 
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ESBS= (index r length , • • •) 

specifies the ESB structure for each NEB. This operand is 
coded as a sublist. Each element of the sublist comprises two 
values; "index” specifies an error group index for which an ESB 
is to be included in the NEB; "length" specifies the status 
area length, in bytes, for that ESB. The parentheses may be 
omitted for a single element, "index" must be specified as a 
two-character representation of a one—byte hexadecimal number 
in the range 01 through FF (a leading zero can be omitted), 
"length" is constrained only by the fact that an eight-byte NEB 
header plus a four—byte header for each ESB must be contained 
within the maximum NEB length of 32767 bytes. If a null value 
is specified, a standard ESB with a status area length of 6 
bytes is assumed. This is suitable for use by the common 
subroutines in maintaining a time—stamped error count. This 
operand is optional and defaults to 1. This causes each NEB to 
be generated with one ESB for error group 1 with a status area 
length of 6 bytes. 


NEBNAME=(name,• •.) 

specifies the names of nodes that are to have a permanently- 
assigned NEB. The names specified are assigned, in the order 
specified, to the set of NEBs requested by the NEBS operand. 
Any remaining NEBs are available for dynamic allocation to 
other nodes as errors occur. "name" must be a string of one 
through four characters. The parentheses can be omitted for a 
single name. This operand is optional and has no default. 


NEBS=number 

specifies the number of NEBs required in the NET. The maximum 
valid number is 32767; the default is 10. 


TIME= (interval,units) 

specifies the time interval that is to be stored in the NET 
header for use by the common subroutines to maintain error 
counts in standard ESBs. If the threshold specified in the 
COUNT operand is not exceeded before this time interval elapses 
then the error count is reset to zero, "units" must be 
specified as SEC, MIN, or HRS. "interval" has the following 
maximum values: (86400,SEC), (1440,MIN) , or (24,HRS). This 
operand is optional and defaults to (7,MIN). 

Note : The above described sample node error program, with a name other 
than DFHZNEP, can be used as a transaction-class routine for the 
interface module, DFHZNEPI. 


USER-WRITTEN NODE ERROR PROGRAMS 


| The use may write several node error programs. When an error occurs, 
the node abnormal condition program passes control to an interface 
module, DFHZNEPI, which determines the transaction class and passes 
control to the appropriate node error program. 

If only one node error program is used, the interface module 
(DFHZNEP) is not required. If the node error program is named DFHZNEP, 
the node abnormal condition program will branch directly to that. If 
more than one node error program is used, the interface module 
(DFHZNEPI) is required. In this case, the node error programs must be 
given names other than DFHZNEP. Every node error program generated must 
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be defined in the processing program table (PPT) by means of a DFHPPT 
| TYPE=ENTRY macro instruction. 


DFHZNEPI MACROS 


The following macros are required to generate the node error program 
interface module (DFHZNEPI): 


• DFHZNEPI TYPE=INITIAL - to specify the name of the default 
transaction-class routine. 

• DFHZNEPI TYPE=ENTRY - to associate the transaction-class with the 
user—written transaction—class error handling routine. 

• DFHZNEPI TYPE=FINAL — to end the DFHZNEPI macro instructions. 


The DFHZNEPI interface module must be generated when the system 
programmer reguires the node abnormal condition program to pass control 
to the appropriate user—written node error program for resolution of the 
error. 


Default Transaction-class Routine — DFHZNEPI TYPB=INITIAL 


The DFHZNEPI TYPE=INITIAL macro instruction specifies the name of the 
default transaction-class routine to be used for the DFNZNEPI module. 

i-1-1-1 

| |DFHZNEPI| TYPE=INITIAL I 

| | | [,DEFAULT=name) | 

i_i_i---1 


DBFAULT=name 

specifies the name of the default transaction-class routine to 
be used. A link will be made to this default routine under any 
one of three conditions: 

(1) Specification of DFHPCT TYPE=ENTRY # NEPCLAS=0 (default). 

(2) Specification of DFHPCT TYPE=ENTRY , NEPCLAS=value >255. 

(3) No transaction-class routine has been specified via the 
DFHZNEPI TYPE=ENTRY macro for the transaction-class value 
identified by the DFHPCT TYPE=ENTRY,NEPCLAS=integer 
specification. 

The DFHZNEPI TYPE=INITIAL instruction must always be specified, and 
must be before any of the other DFHZNEPI macro instruction forms. Only 
one TYPE=INITIAL macro may be specified. 


Transaction—class Error—handling Routine — DFHZNEP I 
TYPE=BNTRY 


The DFHZNEPI TYPE=ENTRY macro instruction is used to associate the 
transaction—class, specified in the NEPCLAS=integer operand of the 
DFHPCT TYPE=ENTRY instruction, with a user—written transaction-class 
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error handling routine. The format of this macro instruction is as 
follows: 


i-1-1--—-- 

| IDFHZNEPI| TYPB=ENTRY 

| | j ,NEPCLAS=integer 

| | | ,NEPNAME=name 

i_i_i_ 


NEPCLAS=integer 

specifies the transaction—class, and must be in the range 1 
through 255. 0 or a value greater than 255 must not be 

specified , nor should any value that has been specified in a 
previous DFHZNEPI TYPB=ENTRY instruction. 


NEPNAME=name 

specifies a name for the transaction—class routine to be 
associated with the specified transaction—class. An error 
condition will result if “name" is specified either as DFHZNEP, 
or is greater than eight characters in length. 

Both the TYPE=ENTRY operands must be specified. 


Terminate Entries — DFHZNEPI TYPB^FINAL 


r 

I 

L 


IDFHZNEPI| TYPE=FINAL 


L 


L 



TYPE=FINAL 

completes the definition of module DFHZNEP and must be 
| specified last. The assembly should be terminated by the 

| statement: END DFHZNEPI. 


Pser—Supplied Error Processors — DFHSNEP TYPE=ERRPROC 


The DFHSNEP TYPE=ERRPROC macro is used to indicate the start of a user- 
supplied error processor (the actual error processor code should 
immediately follow this macro). 

The following operands can be used on the DFHSNEP TYPE=ERRPROC macro 
instruction: 


| IDFHSNEP| TYPE=ERRPROC 

j | j , CODB=(error—code, •.•) 

| | | ,GROPP=error—group—index 

i_i_a_ 


TYPE=ERRPROC 

indicates the start of a user—supplied error processor. 
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CODE- (error-code,.. .) 

specifies the error codes that make up the error group and 
which are therefore handled by the error processor supplied. 

The operand is coded as a sublist of two-character 
representations of one—byte hexadecimal codes (the parentheses 
may be omitted for a single code). For each code specified the 
error group index is placed at the equivalent offset in the 
translate table and thus when this code occurs the appropriate 
error processor can be identified. 


GROUP^error—group—index 

specifies an error group index for the error processor. This 
index is used to name the error processor, locate its address 
from the error processor vector table (EPVT), and optionally 
associate it with an ESB in each NEB. The index specified must 
be a two-character representation of a one—byte hexadecimal 
number in the range 01 through FF (a leading zero can be 
omitted). The error processor name has the form NEPROCxx, 
where »xx” is the error group index. A CSECT statement of this 
name is generated, which causes the error processor code to be 
assembled at the end of the node error program module and to 
have its own addressability. 


CICS/VS users who intend to add their own error processors to the 
sample node error program should be aware of the following conventions 
used by the sample node error program. 

Register Assignment 


Register 

0 

1 

2 

3 

4 

5 

6 

7 

8 
9 

10 

11 

12 

13 

14 

15 


Notes ; 


Use 

Work register 
NET base register 
NEB base register 
ESB base register 

Error count increment, also work register 
Work register 

•< it 

»• it 

n it 

ti •• 

TCTTE base register 

Sample node error program base register 
TCA base register 
CSA base register 

CSVT base and error processor link register 
Common subroutine link register 
Error processor branch register 
Common subroutine branch register 


1. Registers 12 and 13 must be preserved at all times. 

2. Register 14 must be saved for return from error processors. The 
CSVT is coded after the BALR to the error processor and so this 
register is also the CSVT base. 

3. In addition to registers 12, 13 and 14, registers 1, 10 and 15 are 
set up on entry to error processors. 

4. Registers 14—11 may be saved by error processors in an area 
reserved in the TWA at label TWAEPRS• Registers 15—11 do not need 
to be restored before return from error processors. 
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5, Registers 4-9 may be saved by common subroutines in an area 

reserved in the TWA at label TWACSRS. They must be restored before 
return from the subroutines. 


DSECTS 


The following DSECTs are provided: 

No de Error Table Header : This contains the table name and common 
information relevant for all the node error blocks (NEBs) in the table. 


DFHNETH 

DSECT 




NETHNAM 

DS 

CL8 

table name 


NETHNBN 

DS 

H 

no. of NEBs in table 


NETHNBL 

DS 

H 

length of NEBs in table 


NETHTIM 

DS 

BL4 

error count time interval 


NETHECT 

DS 

H 

error count threshold 


NETHFLG 

DS 

X 

flag byte 


NETHINI 

EQU 

X*01* 

table initialized 



DS 

X 

reserved 


NETHFNB 

DS 

OF 

first NEB 


Node Error 

Block 

: The table 

contains node error blocks that 

are used 

for recording error information for individual nodes. These 

may be 

permanently 

r assigned to specific nodes or dynamically assigned at the 

request of 

error 

processors. 



DFHNETB 

DSECT 




NEBNAM 

DS 

CL4 

node name 


NEBFLG 

DS 

X 

flag byte 


NEBPERM 

EQU 

X*01* 

permanently assigned NEB 



DS 

XL 3 

reserved 


NEBFESB 

DS 

OX 

first NEB 



Error Status Block : The NEBs may contain error status blocks. These 
are reserved for specific error processors and are identified by the 
corresponding error group index. An ESB may have a user defined format 
or may have a standard format suitable for counting errors over a fixed 
time interval. 


DFHNETE 

DSECT 



ESBEGI 

DS 

X 

error group index 

ESBFLG 

DS 

X 

flag byte 

ESBSTAN 

EQU 

X*01* 

standard format ESB 

ESBTTE 

EQU 

X *02 • 

time threshold exceeded 

ESBCTE 

EQU 

X * 0 4 * 

count threshold exceeded 

ESBSLEN 

DS 

XL2 

status area length 

ESBHLEN 

EQU 

*—DFHNETE 

ESB header length 

ESBSTAT 

DS 

OX 

status area 


The following fields apply to the standard format: 

ESBTIM DS BL4 time stamp 

ESBEC DS XL2 error count 

C ommon Subroutine Vector Table : The CSVT provides error processors with 
addressability to the common subroutines. The error processor link 
register gives addressability to the CSVT and so the first portion of 
the DSECT overlays the code required to branch around the actual table. 
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DFHNEPC 

DSECT 

DS 

F 

load instruction 


DS 

F 

branch instruction 

CSVTNEP 

DS 

A 

node error program base address 

CSVTESBL 

DS 

A 

NEPBSBL — ESB locate routine 

CSVTNEBD 

DS 

A 

NEPNEBD - NEB delete routine 

CSVTECUP 

DS 

A 

NEPECOP - error count update routine 


3270 UNAVAILABLE PRINTER 


This condition arises when a print request is made through the 3270 
print request facility and there are no printers on the control unit, or 
when the printer (s) is in one of the following conditions: 

• Out of service 

• Not in transceive or receive status for automatic transaction 
initiation 

• A task is presently attached 

• Currently busy on a previous operation 

• Intervention required 

The procedure is applicable to 3270 logical units or the 3270 
compatibility mode logical unit when using the PRINTTO and ALTPRT 
operands of the DFHTCT TYPB=TERHINAL macro. 

The terminal control program recognizes this condition and issues a 
READ BUFFER operation to collect the data into a terminal I/O area. The 
TIOA is of the same format as when an application program has issued a 
terminal control read buffer request. 

The terminal control program VTAM portion (DFHZCP) then queues the 
TCTTE to the node abnormal condition program with the error code X , 42* 
(TCZCUNPRT)• The fields relevant to this situation are: 


TCTTEDA — Data address area 

TWAPRNT — Field for node error program to return information to the 
node abnormal condition program. 

Set to zero on initial entry to node error program 

The node abnormal condition program writes the DFH2497 UNAVAILABLE 
PRINTER message to the CSNT destination and links to the node error 
program with no default actions set. 

On return from node error program, the node abnormal condition 
program will perform the following actions, based upon the TWAPRNT in 
the TWA: 

1. If TWAPRNT is all FFs (—1), the node abnormal condition program 
assumes that node error program has disposed of the data to be 
printed. 

2. If TWAPRNT is zero, the node abnormal condition program assumes 
that no printer is available. 
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3. Ix TWAPRNT is neither —1 or zero, the node abnormal condition 
program assumes that TWAPRNT is the address of the printer. An 
interval control PUT will be performed to the provided terminal. 

The transaction to be initiated is CSPP (print program), and the 
time interval will be zero. 

a. If an error occurs on the interval control PUT, the node 
abnormal condition program will write the DFH2496 IC FAILURE 
message to the destination CSMT. The node abnormal condition 
program will then link to node error program again with the 
TWAPRNT field set to —2. This is done in order for node error 
program to have a last chance to dispose of the data. Upon the 
second return from node error program to the node abnormal 
condition program, the node abnormal condition program will 
reexamine TWAPRNT• If TWAPRNT is —1, this indicates that the 
node error program has disposed of the data. 

b. If no error occurred on the interval control PUT, the node 
abnormal condition program will check for the following printer 
conditions: 


Out of service 
Intervention required 

Other than RECEIVE or TRANSCEIVE status 

If one of these conditions is true, the node abnormal condition 
program will issue the DFH2495 PRINTER OUTSERV/IR/INELIGIBLE— 
REQ QUEUED message to the destination CSMT. 

4. The node abnormal condition program will then terminate any PRINT 
requests on the originating terminal and will perform normal action 
flag processing on that terminal. 


SESSION FAILURES 


Following certain categories of error associated with logical unit or 
path failures, the session between CICS/VS and the logical unit may be 
lost. The default action taken by DFHZNAC may be to put the TCTTE out 
of service. 

A method of automatically acquiring the session again is for the 
user—written node error program to alter the default DFHZNAC actions and 
to keep the TCTTE in service. The node error program can then issue an 
interval control PUT or INITIATE macro against that TCTTE (through the 
TRMIDNT) with a transaction written in a similar manner to the CICS/VS 
good morning sign-on message (CSGM). When the transaction is initiated 
via automatic taski initiation (ATI), CICS/VS will try to reacquire the 
session. If the session fails again, DFHZNAC will be invoked again and 
the process will be repeated. 

The time specified in the interval control PUT or INITIATE macro 
would be determined by installation—dependent expected—mean—time—to— 
recovery values for that installation. 

If used in this way, the initiated transaction can write an 
appropriate sign—on message when the session has been acquired. Note, 
however, that if GMMSG=YES is specified in DFHTCT TYPE=TERMINAL, the 
CICS/VS good morning message will also be initiated at session open 
time. 
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Chapter 4.4. Transaction Abend 


There are five places where user-written recovery logic may be executed 
in CICS/VS: 

• Task level abend exit 

• System abend exit 

• Program error program exit 

• Dynamic transaction backout abend exits 

• The transaction restart facility 

Information about these exits and the differences between OS/VS and 
| VSE recovery appears in the following sections and is shown graphically 
in Figure 4.4—1. Information on system abend exits can be found in 
Chapter 4.5. 
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EXTENDED DESCRIPTION 

CHART 

1 . 

DFHPC RETURN request issued by application program. 
Control passed to DFHPCP. 

A 

2. 

DFHPC ABEND request issued by application program 
or by CICS/VS. Control passed to DFHPCP. 

B 

3. 

Operating system detected a program interrupt. 

Control passed to DFHSRP. 

C 

4. 

Operating system detected an error. Control 
passed to DFHSRP. 

D 


0 


Yes 


No 


Exit to program 
at next higher 
level 



Terminate 

transaction 


Figure 4.4—1 


(Part 1 of 4) . 


Termination and 


Recovery of CICS/VS 
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Look at next 
higher level 


^ there an N 
exit active on 
this level ^ 


Link to program 
or branch to 
routine. Make 
exit inactive 


Return I Abend 


/ Is \ 
transaction 
on highest 
\ level y 


''Dynamic^ 

transaction 

backout 
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Figure 4.4—1 (Part 2 of 4) . Termination and Recovery of CICS/VS 
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Figure 4.4—1 (Part 4 of 4). Termination and Recovery of CICS/VS 


If the program error program (DFBPEP) is defined in the PPT, it will 
be executed every time a task is abnormally terminated. An exit routine 
established by a DFHPC TYPE=SETXIT macro instruction or by a HANDLE 
ABEND command will be executed if a task abend is requested while the 
task is at the level at which the SETXIT was issued, or at a lower 
level. If the task continues to abend, DFHPEP will be entered if 
defined after return from the highest level. 

A recovery routine or program, defined in the SRT, will be executed 
if a task causes the system abend which corresponds to the SRT entry 
abend code. In CICS/VS, after this logic is executed, the task is 
abnormally terminated, and the task level abend exit(s) is (are) 
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executed followed by DFHPEP. However, it should be pointed out that as 
each succeeding exit is entered, the logic is further away from the 
cause of the abend, and the available information and corrective action 
possible are less. 


C HEATING A TASK ABEND EXIT 


The DFHPC TYPE=SETXIT macro instruction and the HANDLE ABEND command 
allow the application programmer to specify the name of a program or a 
routine to be given control when a tasK. completes abnormally. Exit 
programs can be coded in any supported language, but exit routines must 
be coded in the same language as the program of which they are a part. 

For information on the transaction abend codes for abnormal 
terminations that are initiated by CICS/VS, their meanings, and the 
audience actions, refer to the CICS/VS Messages and Codes manual. 

Upon entry to an exit program, no addressability can be assumed other 
than what is normally assumed for any application program coded in that 
language. If the exit logic is in the form of a routine (DFHPC 
TYPE=SETXIT,ROUTINE^.•.), the amount of addressability varies depending 
on the source language (for the macro interface) as follows: 


Assembler: 

Reg 12 — 

TCA address 


13 - 

CSA address 


14 - 

Entry address for routine 


15-11 - 

Varies depending on cause and location of 
Abend 

COBOL: 

Reg 12 — 

PGT address 


13 - 

TGT address 


14 - 

Entry address for routine 


15-11 - 

Contents at time of last CICS/VS service 
request 


For a routine, the register values in the command interface (HANDLE 
ABEND LABEL (...)) are: 


Assembler: Reg 15 — Abend Label 

0—14 — Contents at the time of the 

last CICS/VS service request. 

COBOL: Control returns to the HANDLE ABEND 

command with the registers restored; a 
COBOL GO TO is then executed. 

| RPG II: (VSE only) As for assembler. 

I Note: For the VSE ANS COBOL Subset, Register 12 will not contain the 
PGT address, but whatever it contained at the time of the last CICS/VS 
service request. 

Other information that is available to the exit routine or program 
includes: 

| • The current abnormal completion code at TCACRABC• 

| • The original abnormal completion code at TCAORABC. 
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• Any user—defined information which is placed in the TWA. 

• If the abnormal completion code is ASRA (that is, as a result of a 
program check), the PSW at the time of program interrupt is stored 
in field TCAPCPSW. 

There are three means of terminating processing in an exit routine or 
program: 

• DPHPC TYPE=RETURN or the RETURN command indicate that the task is 
to continue running with control passed to the program on the next 
higher logical level. If no such program exists, the task is 
terminated normally. 

• DFHPC TYPE=ABEND and the ABEND command indicate that the task is to 
be abnormally terminated with control passed either to an exit 
specified for a program on a higher logical level or to the 
abnormal condition program (DFHACP) for abnormal termination 
processing. Branch to some location to retry an operation. It is 
the user*s responsibility to establish registers and code for the 
use of the exit logic. When this method is used and the original 
exit routine or program is to be entered if the retried operation 
fails again, the exit routine or program should issue the DFHPC 
TYPE=RESETXIT macro or the HANDLE ABEND RESET command prior to 
branching, because it will have been disabled by CICS/VS to prevent 
recursive entry into the exit. 

Note: If an abend occurs during the invocation of a CICS/VS service, 

the system programmer should be aware that issuing a further reguest for 
the same service may cause unpredictable results, because the 
reinitialization of pointers and work areas, and the freeing of storage 
areas in the exit routine, may not have been completed. 


PROGRAM ERROR PROGRAM (DFHPEP) 


The distributed version of DFHPEP contains code to establish a base 
register, to establish addressability to the system portion of the TCA, 
and to return control to DFHACP through a DFHPC RETURN operation. This 
| module may be updated to include any user logic. DFHACP will not allow 
| transactions beginning with •C* to be disabled. 

Information available to DFHPEP includes: 


I • 




i • 

i 

i 

i 

i 


The current abend code at TCACRABC. 

Whether the abend code is ASHA, and whether the PSW is at TCAPCPSW. 
The PCT entry address at TCATCPC. 

Any other data placed in the TWA by the application program or 
SETXIT routines. 

Register 1 points to a list of addresses: 

— first address is that of the 4—byte abend code 

— second address is that of the PCT entry 

— third address is that of the return value for PCT disabling 
(TCAPECOM) 
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| If the return value is X t 01 t then the transaction is disabled 

| (provided it does not begin with •C i )• 

If the PCT entry is to be disabled, a hexadecimal 01 should be placed in 
field TCAPECOM at the system portion of the TCA• For example: 

MVI TCAPECOM,TCAPEDIS SHOW PCT TO BE DISABLED 

Note: TCAPEDIS has been eguated to X^l 1 in the TCA dummy section* 

Care should be taken not to disable CICS/VS transactions, a list of 
| which is provided in Appendix A. If a transaction is disabled by 
| DFHPEP, then a message is produced on destination CSMT. 


USER EXITS IN THE DYNAMIC TRANSACTION BACKOUT PROGRAM 


The dynamic transaction backout program (DFHDBP) has four user exits, 
which the system programmer may code if the default action does not suit 
his requirements. The two methods available for using user exits are 
described in Chapter 6.2. The following descriptions of the exits are 
based on the new user exit interface. If an exit is not used, the 
default action corresponds to a return code of 0. 

1. XDBINIT. This exit is given control on entry to DFHDBP. Valid 
return codes are: 

0 to continue dynamic transaction backout 

4 to suppress DL/I backout 

8 to suppress all backout 

2. XDBIN. This exit is given control when each log record (other than 
from DL/I) is obtained. Register 3 points to the record read from 
the dynamic log, which should be addressed using the DFHDBRDS 
DSECT• Valid return codes are: 

0 to continue processing the record 

4 to ignore the record (not applicable to the record 
corresponding to the input message) 

3. XDBFERR. This exit is given control when an error condition has 
been returned from the file control program during the backout 
processing or if an error has been detected by DFHDBP itself. 

Register 3 points to the record read from the dynamic log, and the 
record should be referenced using DFHDBRDS DSECT. Valid return 
codes are: 


0 to accept error and continue 
4 to ignore error and continue 
8 to retry the file control request 

The byte DBRERRCD in the log record is set for different types of 
error as follows: 

DBFEGD 

If an error response is returned from FCP while servicing a GET— 
UPDATE-reguest./ DFHDBP has attempted to retrieve the existing copy 
of the record prior to backing it out. The file control CHECK 
macro in combination with the type of record pointed to by DBRRBG 
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(••read—for—update 11 or ••write-add 11 ) can be used in the exit to 
determine the specific problem. 

DBFBLE 

If the FWA acquired from FCP is not large enough to receive the 
before-copy data picked up from the dynamic log to perform the 
backout. The symbolic register FWACBAR points to the FWA on entry 
to the exit. The file control CHECK macro is not applicable to 
this error. 

DBFEPU 

If an error response is returned from FCP while servicing a PUT- 
UPDATE—request . DFHDBP has attempted to replace the existing copy 
of the record on the file with the ••before—copy” pointed to by 
DBRREG. The file control CHECK macro can be issued in the exit to 
determine the specific error. 

DBFEPN 

If an error response is returned from FCP while servicing a PUT- 
NEW—request. DFHDBP has attempted to add the "before-copy" of a 
deleted VSAH—KSDS data set record. The file control CHECK macro 
can be issued in the exit to determine the specific error. 

DBFEWA 

If the record read from the restart data set is a WRITE—ADD, the 
record is also read in from the file through a GET-UPDATE. For 
ISAH, BDAH, and VSAH—ESDS data sets, no delete function exists. 

The user is given the opportunity to "mark" the existing record on 
the file as deleted according to application-dependent logic. The 
FWA version of the record should be marked. If the user wants the 
| FWA version to be reapplied, a return code of 8 should be 

| specified. 

| Register 6 points to the FWA containing the existing record on the 

| file. The file control CHECK macro is not applicable to the error. 

DBFEVD 

If an error response is returned from FCP while servicing a VSAH- 
DELETE request. DFHDBP has attempted to delete a new record added 
to a VSAH—KSDS data set. The file control CHECK macro can be 
issued in the exit to determine the specific error. 

| 4. XDBDERR. When the DL/I backout routine detects an error, its error 

message is routed to CSflT and this exit is then given control. 

| Register 3 points at the corresponding dynamic log record. The 

information in the TCA fields TCADLII and TCADLIPA is also 
available. Valid return codes are: 

| 0 to suppress further DL/I backout 

| 4 to ignore error and continue 


| User-written dynamic transaction backout exits must be quasi— 
| reentrant. 
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Recoverable resources may be modified in user exits but the following 
should be noted: 

• Changes to recoverable transient data and temporary storage should 

| be avoided in the XDBINIT exit because they will be backed out 

immediately. 

• File control GET for updates should be properly released, either 
implicitly or explicitly, or else backout may be locked out. 

• The current DL/I PSB should be left scheduled; it should not be 
terminated. 

A dynamic log resides initially in a main storage buffer (the dynamic 
buffer, the size of which is specified in the DBUFSZ operand of DFESIT)• 
There is one of these dynamic logs for each transaction (allocated as 
required) that uses dynamic transaction backout and which modifies a 
recoverable file, a DL/I record, or has an input message from a 
protected terminal. If this buffer fills, the contents are rewritten to 
CICS/VS temporary storage, and the buffer is initialized as empty. Any 
record or message that is too large to fit into the buffer is put 
directly into temporary storage and is referenced from the buffer. 

The temporary storage used is either main or auxiliary, as specified 
by the user in the DTB operand of DFHSG PROGRAfl=JCP, and the 
identification used for the dynamic log is '•ffDTBJzfnnn", where n ff" is a 
byte of value X^F* and "nun” is the transaction number. This 
identification should not be specified as recoverable in the temporary 
storage table (DFHTST)• 

Note: Full details of the uses of the dynamic transaction backout 
program can be found in the CICS/VS System/Application Design Guide. 


| Register Usage 

I 

| For the user exit interface, the exit program should save and restore 

| all registers it modifies, using the save area addressed by register 13. 

| For the old user exit facility, the following rules apply: 

• Registers 1, 4, 5, 7, 8, 9, and 15 are to be free for use in all 
the user exit routines without needing to be restored on return. 

• Register 0 (RO) and register 6 (FWACBAR) must be preserved across 
XFERROR (FWACBAR addresses the FRA containing the relevant file 
record). Registers 0 and 6 are free for other exits. 

• Registers 2 (DBLREG) and 3 (DBRREG) must be preserved across 
XINPUT, XFERROR and XDERROR. DBRREG addresses the current dynamic 
log entry. 

• Registers 10 (TCASBAR), 11 (DBPBASE), 12 (TCACBAR), 13 (CSA base), 
and 14 (return register) must be preserved across all the exits. 
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TRANSACTION RESTART 


The CICS/VS transaction restart facility (generated by specifying 
RESTART=YES in DFHPCT TY?E=ENTRY) allows individual tasks (that 
terminate abnormally and are subsequently backed out by the dynamic 
transaction backout facility) to be restarted automatically without the 
need for operator intervention. Transaction restart will, in such cases 
as a program isolation deadlock, function in a manner that is 
transparent to the terminal operator. 

When dynamic transaction backout and transaction restart are used for 
resources that have been defined as non—recoverable, the resource will 
not be backed out. Recoverable resources are backed out up to the 
beginning of the LUW that was current when the transaction abnormally 
terminated. If dynamic transaction backout itself fails, transaction 
restart will not be attempted. 

Dynamic transaction backout invokes certain criteria, including the 
transaction restart program DFHRTY, when a task abnormally terminates. 

If transaction restart is selected, code will be invoked to clean—up 
user storage areas; if restart is not selected, the abnormal condition 
program will be invoked. 

The distributed version of the program DFHRTY contains code to: 

• Establish a base register. 

• Establish addressability to the system portion of the TCA. 

• If restart is about to be attempted, send a message to CSMT. 

• Return control to DFHDBP through a program control RETURN 
operation. 

Flags that are available to DFHRTY are set in the TCA as follows: 

• Byte TCAZLUWT (status of the LUW) contains: 

TCAZRRD (read since last sync point) 

TCAZRWRT (write done since last sync point) 

TCAIOSK (sync point taken) 

• Byte TCADBRTS contains: 

TCADBTRD (task has previously been restarted) 

TCADBTRP (restart to proceed — setable by DFHRTY 

after default setting has been performed by DFHDBP) 

| • TCAORABC (original abend code) . 

| • Byte TCADBRTC contains a count of previous restarts on this task. 

| • TCACRABC (current abend code). 

DFHRTY may be updated to include any user-written logic. Dynamic 
transaction backout will suppress restart (when the abend code is other 
than that for program isolation or a sync point, or if terminal traffic 
after initial input has occurred) unless user—written exit code (DFHRTY) 
tells it to proceed by setting TCADBTRP. Otherwise when transaction 
restart is used, all messages from dynamic transaction backout will be 


Chapter 4.4. Transaction Abend 


425 



suppressed, and the task will be restarted from the beginning, with the 
following information available to it: 

• The initial input TIOA (if any) . 

• The contents of the TCTOA and the command—level communications 
area, as at the start of the task• 

• The TCADBTRD flag (via ASSIGN RESTART command). 
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Chapter 4.5. System Abend 


The system recovery program (described in Chapter 2.2) receives control 
during abend (abnormal termination ) situations. It can either attempt 
recovery or allow CICS/VS to be closed down by the system. It will 
attempt recovery if the abend code passed by the system matches one in 
an entry in the system recovery table (DFHSRT) described in Chapter 3.2 
of this manual. If the corresponding abend code is found, the recovery 
code associated with the SET entry is given control. The transaction is 
subsequently abnormally terminated but CICS/VS continues to function. 
Users may code SET entries and the associated recovery codes. The 
default system recovery table contains certain codes and a recovery 
routine. For further details, see the system recovery table (DFHSRT) 
macro description in Chapter 3.2. 


CREATING A SYSTEM OR USER ABEND EXIT 


The DFHSRT macro instruction allows the system programmer to specify 
logic to be executed following an operating system abend and prior to 
abnormal termination of the CICS/VS partition/region. When abnormal 
termination occurs, control is given by the operating system to the STAR 
| (0S/VS1) or the ESTAE (MVS) exit routine in DFHSRP for processing of the 

abend. If CICS/VS finds an entry in the system recovery table which 
matches the abend code issued by the operating system, the user*s logic 
is executed. This logic can be in either of two formats: 

• A separately compiled program with a corresponding entry in the PPT 
(PROGRAM=name) . 

• A routine coded either inline with the SET following the TIPE=FINAL 
specification, or separately compiled but link-edited with the SRT 
(ROUTINE=name) . 

Several considerations apply to the coding of this logic: 

• In CICS/VS, when control is returned from the abend exit, the task 
in control at the time of the abend is abnormally terminated with 
an abend code of ASRB. If all task abnormal termination exits are 
to be canceled, the character "C 11 should be placed at TCAPCARO of 
the abnormally terminating task*s TCA prior to returning to CICS/VS 
through a DFHPC RETURN reguest for a program, and through a branch 
to register 14 for a routine. 

• The error recovery routines read the TCAPCARO field in the TCA of 
the abnormally terminating transaction to see if CICS/VS considers 
the task to be recoverable. 

| The following characters are set by CICS/VS in TCAPCARO: 

"A» which indicates that recovery of the transaction is possible. 

M H" which indicates that CICS/VS cannot continue after the 
transaction, and will be shut down. 

M A" and ”N« are set by CICS/DOS/VS for the user to examine and act 
upon. 
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The following characters may be inserted in TCAPCARO ay the user: 

| ”C” (for VSE and OS/VS) which cancels the SETXIT, causes the 

transaction to abend, and allows CICS/VS to carry on running. 

| "P" (for VSE) which proceeds with the SETXIT code. The transaction 

is abended, the SETXIT code is activated, and CICS/VS will 
continue. 

CICS/OS/VS will carry on with normal processing if possible after a 
transaction terminates abnormally; the only user action possible is to 
set TCAPCARO to »C« to cancel the SETXIT. CICS/DOS/VS will always 
terminate (for reasons of compatibility with earlier releases) unless 
the user sets TCAPCARO to either ,, P ,f or tt C w , 

If any character other than »C M or "P” is inserted in TCAPCARO, 
CICS/VS will not recover after the abend. 

• In all situations, the reason for the abnormal termination is 

stored in the abnormally terminating task*s TCA at TCAATAC and may 
be interrogated by the recovery logic. The format varies by 
operating system. 


I 0S/VS VSE 

OOxxxyyy OOOOOOzz 

where xxx is the OS/VS system abend code 

yyy is the hexadecimal representation of the user abend code 
| zz is the VSE system abend code 

For example: 

00B37000 is an OS/VS B37 abend. 

000001F5 is a user 501 abend. 

| 00000021 indicates that an invalid SVC (for VSE) 

has been issued. 

• To terminate the recovery logic and return control to the system 
recovery program, the following must be considered. For PROGRAM, 
a DFBPC RETURN reguest is required. For R0UTINE=, a BE 14, where 
register 14 contains the value it contained upon entry to the 
routine, is required. 

• If the recovery logic is in the form of code link—edited with rhe 
table (ROUTINE^), the registers must be saved on entry and restored 
on exit, because a branch interface exists with the system recovery 
program. 

| On VSE and 0S/VS1 addressability may be assumed only for the CSA and 
| TCA. This is the standard assumption for CICS/VS application logic. On 
| MVS, addressability may also be assumed via register 1 to the system 
| diagnostic work area (SDWA). The SDWA is passed by MVS to ESTAE exit 
routines and contains information about the abend condition. For a 
description of the SDWA see the 0S/VS2 Debugging Handbook . For ROUTINE 
the entry address will be in register 15. 

User—written recovery programs/routines written for CICS/VS systems 
with STAE will work correctly without change on CICS/VS systems with 
ESTAE. The reverse is not true if the user code inspects the contents 
of the SDNA• To make such code work on STAE and ESTAE systems, register 
1 should be tested on entry. If it is zero, there is no SDWA to inspect 
(STAE systems). If it is non—zero, it contains the address of the SDWA, 
which can be inspected (ESTAE systems). Note that register 1 will also 
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I be set to zero on ESTAE systems if MVS is unable to obtain space for an 
SDWA . 

Any exit routine appended by the user to DPHSRT source code should 
not contain copy statements for DFHCSADS, DPHTCADS, DFHFCTDS, DFHFWADS, 
or DFHDCTDS , nor should it redefine registers SRTRRBAR, FWACBAR , 
FCTDSBAR, DCTCBAR, and WORKRBG. This is because all these areas already 
exist in the default recovery code generated by the DFHSRT TYPE=FIUAL 
macro. 
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Chapter 4.6. Journal Management 


This chapter contains information on the CICS/VS journal management 
facility, which is an important factor in the recovery and restart 
process. The following topics are discussed: 

• The journal control table, in which the system programmer may 
specify the devices to be used for containing journal records, the 
size of the journal buffers, and additional options which may be 
used during journaling. 

• Application programming within the journaling process; for example, 
opening, closing and reading journal data sets. 

• The layout and contents of journal records. 

• Methods of reading journal data sets. The options are: offline, 
during execution of CICS/VS, backward, and forward. 

The information in this chapter should be read in conjunction with 
the discussion on journaling in the appropriate CICS/VS Application 
Programmers Reference Manual . 

| Information on the type and format of data produced by the CICS/VS 
| monitoring facilities may be found in Chapter 8.8 of this manual. 

Journal management enables the user to create and retrieve journals 
during the execution of CICS/VS. Journals are special purpose 
sequential data sets that reside on tape or direct—access storage, and 
are defined in the journal control table (JCT). 

This chapter includes information to assist in the generation of the 
journal control program and journal control tables and in the writing 
and reading of journal records. A knowledge of the information in the 
journal services section of the CICS/VS Application Programmers 
Reference Manual is assumed. The reader should also be familiar with 
| the appropriate information in the CICS/VS System Programmers Guide . 

Journals are written by journal tasks in two stages. Firstly, the 
user*s application program must issue a DFHJC TYPE=WRITE instruction to 
write the records to the journal buffer, and secondly, the journal task 
must write the records from the buffer to the journal data set. One 
journal task is initiated by system initialization for each journal. 

| These tasks are dynamically assigned a high priority and are normally 
terminated only at system termination time. A few heavily used journal 
tasks are likely to be more efficient than many lightly loaded tasks, 
because they occupy less main storage and would probably be paged out 
less frequently. 

The user should specify the JTYPEID option of the journal control 
output request to assign the journal type identifications so that they 
are unique for each application program and for each type of record. 

The identification and other information described later are written in 
the system prefix to each journal record. 

The system log is a journal which is used by CICS/VS modules and must 
be defined if any of the following features are used: 

• Automatic logging 


Chapter 4.6. Journal Management 


431 



• Automatic Journaling, if directed to the SYSTEM journal file, as 
defined in the PCT and PCI entries. 

• Emergency restart. 

User—written application programs may write to the system log whether 
any of the CICS/VS modules are using it or not. 

Note : If a CICS/VS automatic logging or automatic journaling operation 

to the system log cannot be performed successfully, CICS/VS or the 
transaction that causes the failure will be abnormally terminated as 
appropriate. 


THE JOURNAL CONTROL TABLE 


This section considers some of the factors involved in creating a 
journal control table, including specifying devices and buffer size. 


JOURNAL DEVICES 


A journal may reside on tape or disk and may occupy either one or two 
tape drives or disk extents. This is specified through the JTYPE 
keyword of the DPHJCT TYPE=ENTRY macro instruction. The greater speed 
with which data can be written to tape should be considered in selecting 
the device to be used. This is especially significant when a disk drive 
contains other data sets which may be used concurrently with journaling 
or when the user specifies synchronous journal operations. Tape is also 
the better choice when journaled data is to be retained for a length of 
time • 

Journal tapes are normally rewound and unloaded at end-of—volume or 
when the journal is closed. If two tape drives are assigned to a 
journal, the device is automatically switched at end—of—volume. 

Journal extents on disk are reused when filled. If two extents are 
specified, the system switches back and forth between them. If 
JODRQPT=PAUSE is specified through the DFHJCT TYPE=ENTRY macro 
instruction, an extent will not start to be reused until the console 
operator allows it. This protects the data until the operator verifies 
that it is no longer needed; he may wish to dump the data to tape or 
process it in some other way before it is destroyed. 

All disk extents for journal data sets must be preformatted as 
described in the appropriate CICS/VS System Programmer»s Guide. When 
disk journal data sets are opened at system initialization, the pointers 
are positioned so that output will continue immediately after the last 
record written to the journal. 


BUPPER SIZE 


Journal records are blocked variable—length records. CICS/VS writes a 
block label record as the first record of each block and adds a system 
prefix to each journal record written. (See the section "Format and 
Contents of Journal Records. 11 ) The buffer size is specified by the 
BUFSIZE operand of the DFHJCT TYPE=ENTRY macro instruction. 
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The minimum buffer size is the sum of the following: 


• 42 bytes for the block length field and the block label record. 

• 30 bytes for the record length field and the system prefix. 

• Sufficient space to satisfy the largest journal output request made 
through the journal control request, including: 

— the length of the user prefix (plus 2 bytes) if specified by 
the PFXLGTH operand in the journal control output request. 

— the length of the journal record as specified by the JCDLGTH 
operand in the journal control output request. 

The maximum buffer size is 32767 for tape or the track capacity of 
the device for disk. 

Other factors which need to be considered in selecting buffer size 
include: 

• If DL/I logging is being done through CICS/VS journaling, the 

| minimum buffer size that can be specified is 1100 bytes for 

| CICS/OS/VS. 

• The volume of records to be written. 

• The lengths of the records. 

• The percentage of synchronous requests. (When a synchronous 
request is made, the record is moved to the output area and the 
block is written regardless of its length. Control is not returned 
to the program which issued the journal output request until the 
data is recorded on the journal device.) 

• The advantage of allowing space in the buffer for additional blocks 
to be built while asynchronous blocks are being written. 

The following statistics are gathered for each journal to assist in 
tuning: 

• The number of output requests made. 

• The number of blocks written. 

• The average length of blocks written. 

• The number of times the buffer was full and a Block had to be 
written before the next record could be moved to the buffer. 

• The number of occurrences of buffer shift—up. 

Buffer shift—up is a technique used by journal control to maximize 
free space in a journal buffer. This allows a smaller buffer to be used 
without impacting response time. This technique results in shorter 
output blocks while adding a small processing overhead for buffer 
reorganization. Normally, records are added to a variable—length block 
until there is insufficient free space in the buffer for the record or 
until a block is forced out by a synchronous request. However, when 
using the buffer shift—up technique, the writing of a block may begin 
when the block is filled to the buffer shift—up value. 

For purpose of illustration, assume the following specifications and 
events: The buffer size is 1800 bytes, the buffer shift—up value is 
1200 and no synchronous output requests are made. Records are moved to 
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the buffer until 1140 bytes are used. The next record for this journal 
occupies 80 bytes, including its prefix. The record is moved to the 
buffer and a write operation is initiated for that block because the 
buffer shift—up value is reached. The next block is initiated by 
building its block label record beginning in the 1221st byte of the 
buffer. Control is then returned to the requesting program. This 
journal is able to add records to the next block until output event 
completion time for the previous block. At that time, the second record 
in the buffer is shifted—up, that is, it is moved so that it begins in 
the first byte of the buffer. If the buffer is filled before completion 
of the previous write event, the task will have to wait before shifting 
the buffer. 

The buffer shift-up value is specified by the BUFSUV operand in 
DFHJCT TYPE=ENTRY. The maximum value for this operand, and the default, 
is the value specified by the BUFSIZE operand. With the maximum 
specification, shift—up will never occur. If a user wants to use the 
shift—up technique, it is suggested that he initially specify a shift—up 
value in the range of 50 to 75 percent of the buffer size. The 
statistics described above should be considered for tuning aids. There 
is no minimum for the buffer shift—up value, but it is unlikely that the 
user would specify a value less than 50 percent of the buffer size 
unless his intent is to have a large buffer to prevent paging and yet 
write short journal blocks. However, there is no guarantee that all 
blocks will be short. 

If asynchronous writes are being made to a journal file, and if one 
block is being written because the block size value has reached the 
value in BUFSUV, the next block will have records added to it until the 
last (SIO) has completed. This could result in the next block 
containing more records than are implied by the BUFSUV operand. 

Each journal task acquires space for a TCA, a JCA, and the specified 
buffer size at the time it is created during system initialization. The 
TCA has a TWA length of zero. The JCA is 128 bytes in length. The user 
should do the following to minimize the paging of these areas: 

• Specify CLASS=LONG for the journal task*s entry, transaction CSJC, 
in the program control table. 

• Calculate BUFSIZE such that the total area acquired for the task, 
TCA plus JCA plus BUFSIZE, equals, or is a multiple of, the virtual 
storage page size for the user f s system. 


ADDITIONAL JOURNAL OPTIONS 


The following options may be specified through the JOUROPT operand of 
the DFHJCT TYPE=ENTRY macro instruction. 

RETRY indicates that if an I/O error is detected on output, journal 
control is to close the current volume (tape reel or disk extent), 
switch volumes, and try to write the block on the alternate volume. If 
the retry also fails (or if RETRY is not specified) a permanent I/O 
error condition exists. 

CRUCIAL specifies that this journal is vital to the user*s system and 
CICS/VS will abend when a permanent I/O error is detected. If CRUCIAL 
is not specified, the journal is closed and the journal task is 
terminated. The CRUCIAL option is always in effect at the time the 
journal is opened or volumes are switched. 
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INPUT indicates that the journal may be read during CICS/VS 
execution. An attempt to open a journal for input that does not have 
this option specified will return an invalid request indication. 

PAUSE indicates that operator action is required before the automatic 
switching of disk extents and the reuse of disk space. The DFH4507 
message is sent to the console operator, who must respond YES before 
journaling will continue. If PAUSE is not specified, the DFH4508 
message is sent and the disk extent is overwritten without waiting for 
an operator response. 


APP LICATI ON PROGRAMMING 


Typically, the system programmer will write the application programs 
that open and close journal data sets, but the application programmer 
will code the macro instructions that place records in the data sets. 

This section describes the following variants of the journal control 
macro instruction: 

• DFHJC TYPE=OPEN, which opens a data set. 

• DFHJC TYPE=CLOSE, which closes a journal data set. 

• DFHJC TYPE=GETB or TYPE=GETF, which reads records from a journal 
data set. 

The program that issues these macro instructions must include the 
symbol JCABAR and a COPY DFHJCADS statement to include and address the 
journal control area (JCA). 

The JCA and the DFHJC macro instructions used to place records in a 
journal data set are described in the CICS/VS Application Programmers 
R eference Manual (Macro Level) . The JOURNAL command, which can be used 
in ANS COBOL and PL/I programs to place records in a journal data set, 
is described in the CICS/VS Application Programmers Reference Manual 
( Command Level) . 


OPENING A JOURNAL DATA SET — DFHJC TYPE=OPEN 


The general format of the DFHJC macro instruction to open journal data 
sets is described below. 


| DFHJC | TYPE= (OPEN, {INPUT|OUTPUT} ) 

| | [ ,IDERROR=symbolic—address] 

j | [,INVREQ=symbolic—address] 

| | [ ,IOERROR=symbolic—address] 

| | [ , JFILEID^ {SYSTEM |nn | YES} ] 

| | [ ,NORESP=symbolic—address] 

| | [,SIVOL=YES] 

| | [,STATERR=symbolic—address] 

| | [,VOLERR=symbolic~address ] 

| | [,VOLUME={NEXT|PREVIOUS|CURRENT|FIRST}] 
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TYPE= (OPEN,(INPUT|OUTPUT} ) 

indicates that the specified journal file is to be opened. 

OPEN,INPUT 

indicates that the specified journal volume is to be opened 
for input. 

OPEN,OUTPUT 

indicates that the specified journal volume is to be opened 
for output. Exclusive control of the journal is 
relinquished. 


IDERR OR =sy mbolic-a ddre ss 

specifies the address to which control is passed if the 
specified journal does not exist in the journal control table 
(JCT) . 


INVREQ=symbolic—address 

specifies the address to which control is passed if the TYPE of 
request is invalid. Note that journals to be open for input 
must be specified with JOUROPT=INPUT in the JCT. 


IOERROR=symbolic-address 

specifies the address to which control is passed if the 
operating system open fails. 


JFILEID={SYSTEM|nn|YES} 

specifies the identification of the journal to be opened. The 
default is JFILEID=SYSTEM• 

SYSTEM 

indicates that the journal is the system log data set. 


nn 

is a decimal value from 2 to 99, which identifies the 
journal. 

YES 

indicates that the journal identification has been 
previously loaded in the journal control area field 
JCAJFID. 


N0RESP=symDolic-address 

specifies the address to which control is passed if the 
reguested operation is successful. 


SIVOL=YES 

indicates, for TYPB= (OPEN,INPUT) requests, that a specific 
volume is required. The VOLUME keyword must also be present to 
specify positioning; however, VOLUME=CURRENT is invalid Decause 
SIVOL identifies a specific volume. 
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Note : SIVOL=YES is an invalid request for disk journals 

because all disk journal extents must be permanently mounted. 
Before issuing a DFHJC macro instruction with SIVOL=YES, the 
user must load the journal control area fields JCARST (run 
start time) , JCTVCD (volume creation date), and JCVSN (volume 
sequence number). These three fields pass the volume— 
identification data to journal control. See ”Layout and 
Contents of Journal Records 11 for the format of these fields. 
The data to be placed in these fields can be obtained by 
issuing a DFHJC TYPE=NOTE request. See ”Reading Journal Data 
Sets.” 



STATERR^symbolie—address 

specifies the address to which control is passed if the current 
status of the journal precludes the requested operation. For 
example, the reguest is to OPEN a journal that is already open. 
A status error code is also returned if the request attempts to 
open a journal already under exclusive control of a different 
task. 


VOLERR^symbolic—address 

specifies the address to which control is passed if an OPEN 
request volume error occurs. The requested volume either does 
not exist or cannot be located. 


VOLUME={NEXT|PREVIOUS|CURRENT|FIR ST} 

specifies which volume of the journal data set is required, and 
how that volume is to be positioned when opened. The default 
is VOLUME=NEXT. NEXT and PREVIOUS refer to the time sequence 
in which the tapes are written. Tape volume label data is 
associated with output reels, in this chronological sequence: 
volume sequence number within volume creation date within run 
date. It is the operators responsibility to ensure that tape 
journal volumes are kept and mounted in sequence. Disk journal 
volumes (extents) are permanently mounted, and journal control 
performs any necessary volume switching or positioning. 

NEXT 

indicates, for TYPE= (OPEN ,OUTPUT) requests, that journal 
output is to be continued from the start of the next reel 
or extent. For tape, a new scratch reel must be mounted. 
For disk, reuse of an extent will take place. VOLUME=NEXT 
is not possible if the journal was previously in input 
mode. VOLUME^NEXT will be ignored and VOLUME=CURRENT will 
be forced. 

For TYPE= (OPEN,INPUT) requests, the next volume in 
chronological sequence is to be mounted, if necessary, 
opened for input, and positioned at the start of the data 
set • 


PREVIOUS 

indicates, for TYPE= (OPEN,INPUT) requests, that the 
previous volume in chronological seguence is to be mounted, 
if necessary, and opened for input positioned at the end of 
the data set. 
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CURRENT 

indicates, for TYPE= (OPEN,INPUT) requests, that the current 
output volume (that is, the tape reel or disk extent which 
most recently received output) is to be opened for input 
and positioned at the end of data on the volume. 

Note : If the current tape output reel was closed with 

LEAVE=YES, no remounting or repositioning delay will occur. 

For TYPE= (OPEN,OUTPUT) requests, the current output volume 
is to be opened for output. For tape journals, this 
request is treated the same as VOLUME=NEXT, that is, a new 
output volume is Degun. For disk, the journal is 
repositioned so that output continues after the last record 
previously written. 

FIRST 

can only be used if OPEN=DEFERRED is specified in DFHJCT 
TYPE^ENTRY. 

Note: During system initialization, all data sets included in 

the journal control table are opened with TYPE= (OPEN,OUTPUT) , 
VOLUME=FIRST (unless OPEN=DEFERRED was specified). 

VOLUtt£=FIRST has the same effect as VOLUME=CURRENT, except that 
the sequence numner for this first volume of each data set is 
initialized at 001. 

Note : VOLERR, STATERR, IDERROR, INVREQ, IOERROR and NORESP may be 

specified in a separate DFHJC TYPE^CHECK macro. 


CLOSING A JOURNAL DATA SET — DFHJC TYPE=CLOSE 


The general format of the DFHJC macro instruction used to close a 
journal data set is described below. 



1 

r 

DFHJC | 

TYPE=CLOSE 

-1 


1 

1 

i 

i 

[,IDERROR=symbolic—address] 

[ ,IOERROR=symbolic—addressJ 



1 

i 

[,JFILEID= fSYSTBHInil | YES} ] 



1 

i 

[,LBAVE={NO|YES} ] 



1 

i 

[,NOBESP=symbolic-address) 



1 

i 

L. 

[,STATE8R=symbolic—address] 

_t 


TYPE=CLOSE 

indicates that the specified journal file is to be closed. 
Exclusive control of the journal file is given to the 
requesting task. 


IDERROR=symbolic-address 

specifies the address to which control is to be passed if an 
entry for the specified journal file does not exist in the 
journal control table. 


IOERROR=symbolic address 

specifies the address to which control is to be passed if an 
I/O error occurs. 
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JFILEID-f SYSTEM Inn|YES} 

specifies the identification of the journal to oe closed. The 
default is JFILEID=SYSTEM. 

SYSTEM 

indicates that the journal is the system log data set. 


is a decimal value from 2 to 99, which identifies the 
journal. 


YES 

indicates that the journal identification has been 
previously loaded in the journal control area field 
JCAJFID. 


LEAVE=fNOIYES1 

indicates the positioning for tape journal files. The default 
is LEAVE-NO. The LEAVE keyword is ignored for disk files. 

YES 

indicates that the reel is to remain ready and mounted, 
positioned at the end of the file. 


NO 

indicates that tne reel is to be rewound and unloaded. 


NORESP=symbolic—address 

specifies the address to which control is to be passed if the 
requested operation is successful. 


STATERR-symbolic-a&dress 

specifies the address to which control is passed if the current 
status of the journal precludes the requested operation; for 
example, if the request is to CLOSE an already closed journal. 

A status error code is also returned if the request attempts to 
close a journal already under exclusive control of a different 
task • 


READING JOURNAL DATA SETS — DFHJC TYPE-GET 


The general format of the DFHJC macro instruction used to read journal 
data sets is described below. 

The system acquires an input area into which the journal record is 
moved. The address of this area is returned in the field JCAADATA. The 
user must use this address to establish addressability to the area, 
which is defined by the DFHJCRDS DSECT• See "Layout and Contents of 
Journal Records", which follows. 
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DFHJC | TYPE= {GETB | GETF | NOTE | POINT} 

| [,EOFADDR=symbolic—address] 
| [ ,IDERROR=symbolic—address ] 
| [,INVREQ=symbolio-address] 

| [ ,IOERROR=symbolic—address ] 
| [ , JFILEID={SYSTEM|nn| YES} ] 

| [,NORESP=symbolic-address) 

| [ ,NOTOPEN=symbolic-address] 
| [,STATERR=symbolic—address] 
| [ ,VOLERR=symbolic-address ] 


TYPE={GETB|GETF|NOTE|POINT) 

indicates the journal operation required. 

GETB 

retrieves the journal record preceding the one last 
retrieved. 


GETF 

retrieves the next journal record. 

For TYPE=GETB and TYPE=GETF requests, the address of the 
journal record is returned in the journal control area at 
JCAADATA. The journal record is in CICS/VS transaction storage 
chained off the TCA of the calling program. 

Note : If a direction change occurs, for example, if a GETF 

follows a GETB, the same journal record will be retrieved. 

NOTE 

obtains positioning information for the currently open 
volume of the specified journal. Positioning data is 
returned in the journal control area field JCANOTE, and is 
accurate to logical record within block within volume. 
Positioning data includes the volume identification (fields 
JCARST, JCAVCD, and JCAVSN) needed for DFHJC 
TYPE= (OPEN,INPUT) requests which specify SIVOL=YES. 

Note: Positioning data for a journal open for input is 

returned for DFHJC TYPE=NOTE requests; at least one 
successful GETB or GETF request must precede the NOTE 
request. Positioning data for a journal open for output is 
obtained by including the NOTE keyword in the output 
request: for example, DFHJC TYPE= (PUT,NOTE) . 

POINT 

repositions the currently open input volume to a specified 
logical record. Before issuing this request, the user must 
load the journal control area field JCANOTE with 
positioning data returned by a previous NOTE reguest. 
Following a successful POINT request, the logical journal 
record in question may be retrieved by a GETF request. 

Note: The correct volume of the journal must be currently 
open for input and at least one successful GETB or GETF 
request issued to it, preceding the POINT request. 
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EOFADDR=symbojLic-address 

indicates the address to which control is to be passed if the 
journal reaches end-of—file for GETF, GETB or (tape only) POINT 
requests. 

Note : After end-of—file is passed for a tape journal in the 

forward direction (GETF request), further attempts to retrieve 
from or reposition the volume will lead to unpredictable 
results and I/O errors. 


IDERROR=symbolic-address 

indicates the address to which control is to be passed if the 
specified journal does not exist in the journal control taole. 


INVREQ-symbolic-address 

indicates the address to which control is to be passed if the 
TYPE of operation is invalid or specifies POINT or NOTE before 
any reads (GETF or GETB) from the current input volume. 


IOERROR=symbolic-address 

indicates the address to which control is to be passed if an 
I/O error occurs. 


JFILEID=( SYSTEM Inn|YE S} 

specifies the identification of the journal data set referenced 
in this operation. The default is JFILEID=SYSTEM. 

SYSTEM 

specifies the system log data set. 
nn 

is a decimal value from 2 to 99, which identifies the 
journal. 

YES 

indicates that the journal identification has been loaded 
into the JCAJFID field in the journal control area prior to 
issuing the request. 


NORESP=symbolic—address 

indicates the address to which control is to be passed if the 
requested operation is successful. 


NOTOPEN=symbolie—address 

indicates the address to which control is to be passed if the 
journal is not open. 


STATERR=symbolic-address 

indicates the address to which control is to be passed if the 
journal is open for output, or that the requesting task is not 
the one with exclusive control. 


VOLERR=symbolic—address 

indicates the address to which control is to be passed if a 
POINT request specifies a volume other than the one currently 
open for input. 
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Note: EOFADDR, STATERR, NOTOPEN, VOLERR, IDERROR, INVREQ, IOERROR, and 
NORESP keywords may be specified in separate DFHJC TYPE=CHECK macros or 
HANDLE CONDITION reguests. 


LAYOUT AND CONTENTS OF JOURNAL RECORDS 


Journal data sets are specified as undefined record type, but are 
formatted by the journal control program to correspond to the format of 
variable—length blocked records. That is, each block and each record 
within the block begin with an LLffff length field. Each block contains 
at least two logical records, because journal control creates a label 
record as the first record in every block. 

When retrieved directly from a journal by DFHJC TYPE=GETB or GETF 
reguests, journal records are returned in a CICS/VS transaction storage 
area pointed to by field JCAADATA and are mapped by the DFHJCRDS DSECT. 

The first ten bytes of every journal record, including “label” 
records, consist of these fields: 


Field name in 

Field size 



DFHJCRDS DSECT 

in bvtes 

Format 

Contents 

JCRBA 

EQU 

* 

Label for start < 
journal records. 

JCRLL 

2 

Halfword binary 

Length of record 

JCRBB 

2 

Binary Zeros 

Not used 

JCRSTRID 

2 

Hexadecimal 

System type—ID 

JCRUTRID 

2 

Hexadecimal 

User type—ID 

JCRLRN 

2 

Packed decimal 

Record number 
within block 


The system and user type—ID fields, JCRSTRID and JCRUTRID, are the 
means of distinguishing journal records output by CICS/VS, by such 
features as automatic journaling, from those output by direct user 
reguests. 

For user journal requests , byte 1 of the system type—ID field always 
contains binary zeros; the user type—id field contains the two—byte 
hexadecimal code specified by the JTYPEID keyword of the output request. 

For CICS/VS journal requests , the user type—id is zero, and the 
system type—id consists of a 1—byte function code followed by a 1—byte 
module code. Valid settings of these codes are consolidated into the 
member DFHFMIDS of the CICS/VS assembler—language macro library as shown 
in Figure 4.6—1 below. 
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FUNCTION AND NODULE IDENTIFIERS 
(SEE FOLLOWING DSECTS: DFHDWEDS,DFHJCADS,DFHJCR 


FUNCTION IDENTIFIERS 


X*01* THRU X 1 7F * ARE RESERVED 

X *20* PLUS X *8—• ...USE FOR AUTOMATIC JOURNALING 
X* 40* PLUS X *8— 1 ...USE FOR AUTOMATIC LOGGING 
X*F-* COMPOSIDE CODE RESERVED FOR SYNC—POINT LOGGING 
(MUST BE PRESENT IN •LOGGABLE* DWE*S) 


JOURNAL CONTROL 


FIDJCLAB BQU X*80« 


... JOURNAL CONTROL LABEL RECORD 



TEMPORARY STORAGE FUNCTION IDENTIFIERS 



ACTIVITY KEYPOINT 


FIDAKS 

FIDAKE 

FIDKPTCA 

FIDKPDCT 

FIDKPTCR 



SYNC POINT 


FIDLSOSP 

FIDLEOTK 

FIDPEOTK 


m W ■, 

!r? 


X *F1 • 

X *F2 • 
X *F3 * 
X*F5* 


LOGICAL START OF SYNC POINT 
LOGICAL END-OF-TASK 
PHYSICAL END—OF—TASK 
SYNC POINT REQUEST 


Figure 4.6—1 (Part 1 of 2). Journal Function and Module Identifications 
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* 

♦ * 

Jk . ___ 


BBS 

FUNCTION 

IDENTIFIERS 

♦ 

-* 

* 

FIDBMPM 

EQU 

X*81* 

m m m 

BMS PARTIAL MESSAGE ON 



♦ 




TEMPORARY STORAGE 



♦ * 

Jfe 


TERMINAL CONTROL 

* 

* 

FIDTCML 

EQU 

X f F0 • 

SYNC 

• PT—LOG SEQ.NUMBERS... 



♦ 



... THE 

ABOVE PLUS ANY OF FOLLOW*G 2... 



FIDTCDWL 

EQU 

X'01» 

• * • 

DEFRD.WRITE DATA 



FIDTCFMH 

J|c 

EQU 

X 1 02 • 

... 

+ FMH 



FIDTCAL 

EQU 

X^O* 

AUTOMATIC LOGGING MASK... 



FIDTCAJ 

EQU 

X*20» 

AUTOMATIC JOURNALING MASK... 



♦ 



... THE 

ABOVE 2 PLUS 1 OF FOLLOW*G 9... 



FIDTCTL 

EQU 

X^O 1 

• • • 

SEQ.NR. ONLY (L ONLY) 



FIDTCIM 

EQU 

X *81 * 

# • # 

INPUT MESSAGE (L AND J) 



FIDTCOM 

EQU 

X •82* 

• • • 

OUTPUT MESSAGE (J ONLY) 



FIDTCWP 

EQU 

X*83 • 

• • • 

WRITE WAS PURGED (L ONLY) 



FIDTCPPR 

EQU 

X '84 • 

• • • 

POS.RESP.REC *D (L ONLY) 



FIDTCIMF 

EQU 

X • 85' 

• • • 

INPUT MSG (W/FMH) (L AND J) 



FIDTCOMN 

EQU 

X *86* 

• • • 

OUTP MSG (W/O FMH) (J ONL) 



FIDTCON 

EQU 

X'87* 

... 

OUTP MSG, FMH, CCOMPL=NO 



FIDTCONN 

Jk . ... 

EQU 

X * 88* 

... 

OUTP MSG, W/O FMH, CCOMPL=NO 



* * 


MODULE IDENTIFIERS: 

* 

♦ 


* - * 



MUST CONFORM TO STANDARD MESSAGE CODES 



MAY 

BE X^l*—>X *FF 1 

MODIDKC 

EQU 

X • 03 * 

... TASK CONTROL 

MODIDPC 

EQU 

X *04* 

... PROGRAM CONTROL 

MODIDSC 

EQU 

X *05 * 

... STORAGE CONTROL 

MODIDDC 

EQU 


... DUMP CONTROL 

MODIDIC 

EQU 

X 1 08 # 

... INTERVAL CONTROL 

MODIDTC 

EQU 

X'10* 

... TERMINAL CONTROL 

MODIDFC 

EQU 

X • 11 * 

... FILE CONTROL 

MODIDTD 

EQU 

X # 12* 

... TRANSIENT DATA 

MODIDTS 

EQU 

X ■ 13 1 

... TEMPORARY STORAGE 

MODIDDL 

EQU 

X»39* 

... DL/I INTERFACE 

MODIDBM 

EQU 

x^ao* 

... BASIC MAPPING 

MODIDJC 

EQU 

X'H5* 

... JOURNAL CONTROL 

MODIDKPP 

EQU 

X 1 54 • 

... KEYPOINT PROGRAM 

MODIDBI 

EQU 

X *55 • 

... BUILT-IN FUNCTIONS 

MODIDAKP 

EQU 

X • 58 • 

... ACTIVITY KEYPOINT PROGRAM 

MODIDSPP 

EQU 

X 1 59 • 

... SYNC-POINT PROGRAM 

MODIDUSR 

* 

EQU 

X 1 FF • 

RESVD.FOR USER SYNC-PT.SUPRT 

... * 

Figure 4. 

6-1 (Part 

2 of 2) 

. Journal Function and Module Identifications 

After 

the above 

common 

fields, journal records follow one of two 


formats. 

The first format applies only to the first record of every block. 
These are journal managements "label" records, which continue thus: 
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Field name in 
DFHJCRDS DSECT 

Field size 
in bvtes 

Format 

Contents 

JCLRJFID 

1 

Binary 

Journal id 
(X*01 • - X*99•) 

JCLRBLKN 

3 

Packed decimal 

Block number (1-n) 

JCLRVCD 

4 

Packed decimal 

Volume creation 
date (ooyydddt) 

JCLRVSN 

2 

Packed decimal 

Volume sequence 
number (nnn+) 

JCLRLBW 

4 

Binary (disk) 

Relative TTR of 
previous block 

JCLRTBAL 

2 

Binary (disk) 

Track—balance from 
previous block 

JCLRTIME 

4 

Packed decimal 

Time block written 
(hhmmsss+) 

JCLRRST 

4 

Packed decimal 

Run start time 
(hhmmsss+) 

JCLRDATE 

4 

Packed decimal 

Date block written 
(ooyyddd+) 

All other journal records, which are created in 
requests (DFHJC macro instructions), are continued 
three variable—length segments, in this order: 

response to external 
with from one to 

• System prefix 



• User prefix (if any) 



• Journaled 

data 



System prefix: Every iournal record includes a system prefix that is 
variable in length. The system prefix serves to identify the origin of 
the record and contains at least the following data: 

Field name in 
DFHJCRDS DSECT 

Field size 
in bytes 

Format 

Contents 

JCSPBA 

EQU 

* 

Label for system 
prefix begin address 

JCSPLL 

2 

Halfword binary 

Length of system 
prefix 

JCSPFS 

3 

Binary 

Flags 

Note: 

The first two bytes are reserved for future expansion. 


The third byte is field JCSPF1. The settings are: 
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JCSPUP 

JCSPSOTK 

JCSPLSTK 

JCSPRRIF 

JCSPMIDT 

EQU 

EQU 

EQU 

EQU 

EQU 

x # ov 

x § 02 

X *04 • 

x^s* 

X • 10 • 

... User prefix present in record 
... Physical start—of—task 
... Logical start-of—task 
... DFHRUP record in-flight flag 
.•. Output message in doubt 

JCSPTASK 


3 

Packed decimal 

Task number as in 
TCAKCTTA 

JCSPTIME 


4 

Packed decimal 

Time of request 
(hhmmss s+) 

JCSPTRAN 


4 

Characters 

Transaction ident 
(or binary zeros) 

JCSPTERM 


4 

Characters 

Terminal 

identification 

JCSPREA 

EQU 

* 

Label for end of 
system prefix 
common root 


System prefix additional data : For some CICS/VS journal requests, 
additional data is included in the system prefix to further identify the 
originator of the request. This additional data follows the above 
common fields and is usually variable in length; hence the need for the 
length—field JCSPLL at the start of the system prefix. 

For journal records created by the CICS/VS file control program's 
automatic journaling or automatic logging features, the additional data 
in the system prefix is: 

Field name in Field size 

DFBJCRDS DSECT in bytes Format Contents 

JCSPFCFI 8 Character File id 

JCSPFCRI EQU * Start location label 

for record ident. 

(None) 1 to 255 Record identification 

Note that the DSECT does not provide a label for the record 
identification field itself since the user determines its length by the 
use of a DS field definition statement following the COPY DFBJCRDS 
statement. 

For journal records created by the CICS/VS terminal control program's 
automatic journaling or automatic logging features, the additional data 
in the system prefix is: 


Name Bytes Format Contents 

JCSPTCVS 4 2 halfwords VTAM's sequence numbers 

(2 bytes inbound followed 
by 2 bytes outbound) 

JCSPTCL EQU * Label for end of terminal 

control's prefix 

For journal records created by the sync point program during 
| intercommunication sync point processing, the additional data in the 
system prefix is: 
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Name Bytes 

Format 

Contents 

ORG JCASPREA 




JCAISSQI 

2 

1 

halfword 

Sequence number of last 
inbound sync point request 

JCAISSQO 

2 

1 

halfword 

Sequence number of last 
outbound sync point request 

JCAISFL 

1 

1 

byte 

Flag 

JCAINDT 

EQU 

X^SO’ 


•In—doubt 1 

JCASSPR 

EQU 

x*40' 


Sync point request sent 

JCAISAB 

EQU 

x^o* 


Successful abort 

JCANDTB 

EQU 

X • 10 1 


No DTB if 'in-doubt* 

JCAIFAIL 

EQU 

x'os* 


Session failed 

JCAISOP 

DS ( 

:l3 


Operator id 

JCAISTM 

DS < 

3L4 


Intersystem terminal id 

JCAISSPL 

EQU 

♦-JCASPBA 

Intersystem communication 
system prefix length 


User—prefix : The user prefix is optional, and is placed in a journal 
output record next to the system prefix, in response to the PFXADDR and 
PFXLGTH keywords of the journal control output request. As with the 
system prefix, the user prefix always begins with a halfword binary 
length field; the data indicated by the PFXADDR keyword follows. For 
journal records that include a user prefix, the flag byte JCSPF1 of the 
system prefix has the indicator bit JCSPUP set to one. 

Journaled dat a; The final segment of journal records is the main data, 
as specified by keywords JCDADDR and JCDLGTH of the journal control 
| output request. The length of the data portion of a journal record can 
be computed by subtracting from the length of the journal record (JCRLL) 
the length of the record prefix (10 bytes) and the length of the system 
prefix (JCSPLL) and the length of the user prefix (in the field, if any, 
defined by the user)• 


READING JOURNAL DATA SET S 

Journal data sets may be read in the following ways: 

• Either offline or while CICS/VS is executing 

• Backward or forward 

This section describes each of these methods. 

READING JOURNAL DATA SETS OFFLINE 
| The information in this section is presented in terms of: 
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How to wrxte an offline program to read the journal data sets 
Using the offline program 




Writi ng The Offl ine Program 


Journal data sets can be read by user—written offline programs. 

Although written as operating—system undefined (U—format) records by 
CICS/VS journal management, the blocks are compatible with records of 
the variable length blocked (VB) format. Each block begins witn a four- 
byte block—length field (•LL/#*), and each logical record within a block 
begins with a four—byte record—length field (■ LL^b*). The data set 
label information will indicate U—format, but this can be overridden to 
VB (by a DD statement in OS/VS or by a DTF statement in VSE) so that 
data management wxll deblock records and will provide them to tne 
offline program. 

Further information on the layout and contents of journal records can 
be found in Figure 4.6—1. 

The user should be aware that unless a journal volume was 
successfully closed when last output during CICS/VS execution, there may 
be no end-of—file indicator on the volume, and data may run into old 
records and wrongly formatted blocks. 

Offline user—written programs can map journal records by issuing the 
DFHJCR CICSYST=YES statement, which results in the DFHJCRDS DSBCT being 
included in the program from the CICS/VS assemoler—language macro 
library. The DSECT so generated is identical to that obtained for 
CICS/VS programs by the COPY DFHJCRDS statement, except that the fields 
are not preceded by a CICS/VS storage accounting area. The DSECT is 
intended to map journal records directly in the block, rather than in a 
CICS/VS storage area (see "Reading Journal Data Sets during CICS/VS 
Execution", below). 


U sing The Offline Program 


The offline program can be executed against a DISK or TAPE journal 
device. The following points should be considered: 

• For a DISK journal, two extents must be allocated. The 3 ournal can 
be read while CICS/VS is still active, in which case, the 
appropriate JCT option (JOUROPT=PAUSE) and JCL statement (DISP=SHE) 
must be specified. The JCL for the offline batch program must also 
be written. The user is responsible for ensuring that journal 
volumes are read in the required sequence. With disk journals that 
have two extents allocated (JTYPE=DISK2 specified in the JCT), the 
problem reduces to that of concatenating DD statements in OS/VS and 
DLBL and EXTENT statements in VSE in the correct order. 

• For a TAPE journal, the journal volume can be removed and read 
whenever the user desires. Another tape volume can be mounted to 
record data while the first volume is being processed. The 
advantages of a tape journal over a journal on a disk device are 
that the job to read the tape journal can run for a (relatively) 
long time and is usually easier to process clerically because there 
is no need to alternate between the separate information on the two 
disk extents. 
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READING JOURNAL DATA SETS DURING CICS/VS EXECUTION 


Journals are designed to be high—usage, shared output files, and are 
normally opened for output at system initialization. No master terminal 
facility is provided to prevent writing to a journal. This is in 
keeping with the primary function of journals, that is, to enhance the 
integrity of the data by providing audit trails and backup files. 

However, provision is made for reading journals online; the data can 
be read either forward or oackward. To read a journal, a task must 
first close the journal, at which time the task is given exclusive 
control of the journal. Exclusive control is released when the task 
reopens the journal for output. While the journal is under the 
exclusive control of a task, output will not be attempted. If the task 
that owns the journal requests a write, control will be returned with an 
invalid—reguest condition. If any other task requests a write to the 
journal, that task will be put in a wait state until the journal is 
available for output. 

It is the user's responsibility to release exclusive control of a 
journal by opening it for output. To ensure that this is done in case 
of abnormal termination of the controlling task, the user should 
establish an abend exit routine for the task through the DFHPC 
TYPE=SETXIT macro instruction or a HANDLE ABEND command. The exit 
routine should restore the journal to output status. 

Before a task that is expected to retain exclusive control of a 
journal for more than a few seconds is initiated, plans should be made 
to disable any other transactions which might issue requests to that 
journal. Disabling and enabling of transactions can be accomplished 
through the master terminal facilities of CICS/VS (see the CICS/VS 
O perators Guide) . 

Because the format of journal tapes is compatible with that of 
extrapartition data sets, it is possible to read journals written 
previously by means of the transient data facility, provided the 
necessary entries have been added to the destination control table. 


READING A JOURNAL BACKWARD 


Certain functions may require access to a few journal records that were 
written in the preceding minutes of operation. The purpose of this 
action is usually corrective, such as for backing out updates to the 
data base by a task which subsequently terminated abnormally. The 
records to be retrieved would probably be the ••before" image of data 
base records that were written to the system journal by the automatic 
journal feature. Since this type of operation is likely to retain 
exclusive control of a journal for only a few seconds, it is unlikely 
that the user would want to disable other transactions that issue 
requests to the journal. The sequence of events considered here for 
this application might be as follows: 

1. A DFHJC TYPE=GETJCA macro is issued to acquire a journal control 
area for the input records. 

2. A DFHJC TYPE=CLOSE,JFILEID=SYSTEH macro is issued to close the 
journal file and give exclusive control to the requesting task. If 
the journal is on tape, LBAVE=YES is also specified so that the 
file will remain properly positioned after the last output block. 
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3. A DFHJC TYPE= (OP BN,INPUT),VOLUME=CURRENT,JFILEID=SYSTEM macro is 
used to open the journal for input, using the current tape volume 
or disk extent. This also implies that the journal is to be read 
backward beginning with the last output block. 

Note that standard tape labels should not be used for a journal 
that can be read backward because such a tape would be rewound at 
this time. 

4. DFHJC TYPE=GETB,JFILEID=SYSTEH,EOFADDR=address macro instructions 
are issued to read the journal records in reverse chronological 
sequence. Note that an attempt by this task to update the data 
base at this time could initiate a request for automatic journaling 
which in turn would return an invalid request condition because the 
system journal is closed for output. Instead, journal records to 
be used for later updating can be retained on the transactions 
storage chain. Other journal records are discarded by issuing a 
DFHSC TYPB=FRBEMAIN macro. 

When the Beginning of a tape reel or a disk extent is encountered 
while reading backward, an end—of—file condition is indicated. The 
user*s end—of—file routine should switch to the preceding volume or 
extent by issuing the following macro instructions: 


DFHJC TYPE=CLOSE,JFILBID=SYSTEM 

DFHJC TYPE= (OPEN,INPOT),VOLUM E=P REV100 S,J FILEID=S YS TEH 

The positioning is again after the last output block on the volume 
or extent. If there is no previous volume, a VOLERR condition code 
is returned. 

Note that for disk journals the one or two extents specified are 
periodically reused. An attempt to read backward so far that 
logical wrap-around occurs will usually result in an I/O error. 

The unlikely case that an I/O error does not occur can be detected 
by a sequence break in the time—and—date stamp in the journal 
record prefix. 

5. A DFHJC TYPE=CLOSE,JFILBID=SYSTEH macro is issued to close the 
system journal for input after all desired records have seen read. 

6. A DFHJC TYPE= (OPEN ,OtJTPOT) , VOLUfiE=CURRENT , JFILEID=SYSTEM macro is 
issued to release exclusive control of the system journal and make 
it availanle for output. If the journal is on disk, the data set 
is positioned after the last record written; if on tape, the 
VOLUME=CURRENT is ignored and output resumes with a new reel. 

The task can now process the records retained in step 4. 


READING A JOURNAL FORWARD 


Some application programs need to read large volumes of journal records. 
These application programs would typically take considerably more than a 
few seconds to execute, and would therefore only be practical if the 
journal is on tape and is not being accessed by any other task. The 
volumes being read would probably have been written and closed at some 
previous time, and would be defined as a separate journal table entry 
for the application program that reads them. 

For example, assume an application program that is to read previously 
written reels of the system journal. An entry is made in the journal 
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control table defining this file as JFILEID=13. The sequence of events 
considered here for this application program might be as follows: 

1. A DFHJC TYPB=GETJCA macro is issued to acquire a journal control 
area for the input records. 

2. A DFHJC TYPE=CL0SE,LEAVE=N0,JFILEID=13 macro is issued to close the 
journal file; the task is also given exclusive control of the 
journal. LEAVE=NO causes the current output reel to be rewound and 
unloaded. Note that this journal/ as all other journals/ is opened 
for output at system initialization/ except when OPEN=DEFERBED has 
been specified in the journal control table. 

3. A DFHJC TYPE= (OPEN,INPUT),VOLUME=NEXT,SIVOL=YES,JFILEID=13 macro is 
issued. VOLUME=NEXT causes the volume to be positioned to read 
forward beginning with the first block. SIVOL=YES requests a 
specific tape input volume. The program must have previously moved 
the volume identification of the first volume to be read into the 
journal control area. 

4. DFHJC TYPE=GET,EOFADDR=addr,JFILEID=13 macro instructions are 
issued to read the journal forward. Each request retrieves the 
next logical record. 

If an end-of—file is encountered and more records are to be read by 
the task, the following macro instructions are issued in the end- 
of—file routine: 


DFHJC TYP£=CL0SE,JFILEID=13 

DFHJC TYPE=(OPEN,INPUT),VOLUME=NEXT,JFILEID=13 

5. When all desired data has been read, a DFHJC TYPE=CLOSE,JFIELID=13 
macro instruction is issued to close the journal for input. 

6. A DFHJC TYPE= (OPEN,OUTPUT) ,V0LUME=CURRENT,JFILEID=13 macro is 
issued to release exclusive control of the journal and make it 
available for processing by other tasks or for the system to close 
it at system termination. This action will open a new tape volume 
and will write a label on it. 

All journal data sets entered in the journal control table are 
normally opened for output during system initialization. The user may 
defer opening of selected journal data sets by specifying OPEN =DEFEBBED 
in the journal control table. This could be used to allow a user 
program to open a journal for input to read the files written during a 
previous execution of CICS/VS. The user may want to execute this 
program during post—initialization processing by entering it in the 
appropriate program list table (PLT). When the deferred open option is 
used, it is necessary for the program that first opens tne journal to 
issue a special form of the DFHJC macro in place of the normal DFHJC 
TYPE=GETJCA• It is: 


DFHJC TYPE= (GETJCA,OPEN) ,VOLUME=FIBST, 

JFILEID=nn,NORESP=symbol 

This macro gives the requesting task exclusive control of the journal 
data set, acquires a journal control area, and collects the current 
extent pointer information if a disk file is referenced. The user may 
then issue a subsequent DFHJC TYPE=OPEN for input or output, current or 
previous volume according to the conventions described above. 
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Chapter 4.7. Warm Restart 


CICS/VS warm restart restores the status of the following information to 
their status at a previous warm shutdown of the CICS/VS system: 

• Intrapartition transient data 

• Processing program table (PPT) 

• Program control table (PCT) 

• Terminal control table for non—switched terminals and lines 

• File control table 

• Interval control elements 

• Automatic initiate descriptors 

• Batch control areas for asynchronous transaction processing (ATP) 

• Write request elements for ATP 

• Auxiliary temporary storage tables and the bit use map 

• Common system area parameters saved by the warm keypoiat 

In some situations a full warm restart may not be necessary. The 
alternatives are a partial warm restart (where tables are individually 
warm or cold started) , or a cold start. The system programmer^ only 
involvement in this facility is to define in the system initialization 
table which resources are to be restarted. 

The warm restart facility is only available after a previous 
controlled shutdown of CICS/VS (that is, when CSHT SHUT,NO has been 
issued). The facility may also be used after an abnormal shutdown. The 
ABKPOPT option in DFHSIT determines whether a warm keypoint should be 
taken during abnormal shutdown. Note, however, that if the system has 
protected resources, warm restart will not perform backout of any 
uncompleted changes made to these resources before the shutdown. Rather 
than perform a warm restart, an emergency restart should be made. 

The processing program table (PPT) may be HOT started if PPT=HOT is 
specified in DFHSIT. The difference between warm and hot starts for the 
PPT is that on a HOT start the track/address (TTR) fields in the PPT are 
recovered and there is no need to go through the BLDL routine. The HOT 
start facility can only be used if no modules are recataloged during the 
period that CICS/VS is down. 
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Chapter 4.8. Emergency Restart 


The following chapter contains information which the system programmer 
may require to implement the emergency restart feature of CICS/VS, which 
is invoiced by specifying START=EMER or START= (BMER, ALL) as system 
initialization override parameters. Further information on these 
parameters can be found in the appropriate CICS/VS System Programmer*s 
Guide (DOS/VS or OS/VS). 

The following topics are discussed in this chapter: 

• '‘Problem determination” provides guidance on determining the cause 
of an abnormal system termination. It is possible that the same 
problem may also cause the emergency restart facility to fail. 

• "Transaction backout" describes the various aspects of the 
transaction backout program which may be used to backout the 
effects of transactions which were being processed when the system 
failed. 

• "Processing transaction backout data" describes the ways in which 
the system programmer may provide user—written data base recovery 
supp ort. 

• "User activity keypointing" provides guidance on writing 
information to the system log for use during emergency restart. 

System failures during the emergency restart function represent one 
of the most difficult types of failures to diagnose and correct. 
Therefore, the user must be fully aware of the functions performed 
during emergency restart, the sequence in which these functions are 
performed, and the effect that abnormal termination during emergency 
restart has on data bases and tables. 


PROBLEM DETERMINATION 


Prior to initializing emergency restart, an analysis of the failure 
which caused the system to terminate should be performed. It is 
possible that the condition which caused the system to abend will also 
cause emergency restart to fail. One example of this is a physically 
damaged data set which caused a system abend, causing the identical 
failure to recur during emergency restart when the user attempts to back 
out updates to that data set. 

If a file control data set has become physically damaged, user- 
provided data set recovery program(s) will have to recover the data set 
prior to attempting to back out updates to this data set. Data set 
recovery involves restoring the contents of that data set from some 
previous copy and then applying all updates made to it since the copy 
was taken. CICS/VS automatic journaling can be used to keep track of 
data set updates performed during online execution. 

If the intrapartition transient data data set becomes physically 
damaged, it will not be possible for CICS/VS to perform emergency 
restart on it. CICS/VS recovery is dependent upon the physical location 
of data on this data set as it existed prior to system failure. 
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If any failure is encountered prior to completion of emergency 
restart, the following procedure must be followed: 

• Determine the cause of the failure: The cause of the failure of 
emergency restart must be determined and corrected. If the 
intrapartition transient data data set is damaged, it must be COLD 
started by CICS/VS (however, its contents may be restored by the 
user during post—initialization processing if possible). If a data 
base is damaged, it must be recovered by user data base recovery 
utilities. 

• Restart emergency restart: The emergency restart procedure is 
executed again using the OLD system log as input. The OLD system 
log is the volume which was being used for output when the original 
system failure occurred. Because this data set is not used for 
output during emergency restart, its contents are valid to use to 
restart the emergency restart procedure and recover CICS/VS to its 
status prior to abnormal termination. 

At the completion of emergency restart the recovered status of 
CICS/VS has been recorded on the NEW system log data set if system 
execution is to proceed, or on the system restart data set through the 
warm keypoint function if the system is to be terminated. This status 
represents the point of synchronization to which the system has been 
logically recovered. If restart becomes necessary from this point on, 
the new system log must be used for restart. 

If the system was terminated upon completion of emergency restart, 
the system restart data set contains the fully recovered CICS/VS status 
in the form of a warm keypoint. A CICS/VS warm start may be performed 
using this data set to initiate CICS/VS execution with the recovered 
system status. 


TRANSACTION BACKOUT 


CICS/VS users can provide their own transaction backout support 
following a CICS/VS system failure as described in "Processing 
Transaction Backout Data” later in this chapter, or can use the CICS/VS 
transaction backout program (DFHTBP) • 

DFHTBP is responsible for backing out changes made to file control 
data sets, recoverable auxiliary storage temporary storage data sets, 
DL/I data bases, and recoverable intrapartition transient data, by 
transactions which were in-flight at the time that the system was 
interrupted. It is also responsible for collecting messages in support 
of message recovery and resynchronization following a system failure. 

DFHTBP provides exits and options that allow the user to participate 
in the recovery process with minimal programming effort. This section 
of the manual describes the functions performed by DFHTBP, the types of 
records logged by CICS/VS in support of data base backout and message 
recovery, and the user exits provided in DFHTBP. 

The following paragraphs are provided to clarify terms used in the 
description of DFHTBP. 

When the activity of a task affects a protected resource, recovery 
information relative to that activity is recorded on the system log, and 
the first such record associated with the task is flagged to indicate 
"start—of—task 
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There is a point in the life of a CICS/VS task at which all activity 
on protected resources is committed and cannot be backed out. This 
point is known as the end of a logical unit of work ("LUW" or "sync 
point") and its occurrence is recorded on the system log. This point 
corresponds to a user sync point request during the transaction. 

A task can explicitly declare that it has reached a point in 
processing at which all activity to that point is to be considered 
committed by issuing a CICS/VS DPHSP (sync point) request. Once the end 
of the Law has been recorded on the system log, the task will begin its 
next LUW and the first record written to the system log (because of the 
task*s activity in the new LUW) will also be flagged as "start—of—task." 
Therefore, a single task can have multiple LUWs, intermediate sync 
points between LUWs being explicitly declared, and a final LOW which 
ends implicitly when the task terminates. CICS/VS treats each LUW as a 
recoverable process and will back out the effect the task had on 
recoverable resources during an LUW if CICS/VS is abnormally terminated 
before a task completes that LUW. A task in this state at the time of 
abnormal termination is called "in—flight." 

An output message whose delivery was deferred until after the 
completion of an LUW is called a committed output message. Even after 
delivery of a committed output message has neen initiated, its receipt 
is considered "in—doubt" until a definite response has been received by 
CICS/VS and the response has been recorded on the system log. 
Resynchronization involves restoring the inbound and outbound sequence 
numbers assigned to message traffic to some agreed-upon values, and 
requires the participation of CICS/VS and intelligence at the terminal. 
Because the recovery/restart philosophy of CICS/VS is backing out the 
effect that in—flight tasks had on recoverable resources, 
resynchronization can result in backing up these sequence numbers to a 
point prior to task initiation (in effect ignoring the existence of 
physical messages sent and received during the life of the in-flight 
task). These sequence numbers (collectively) are called "resync data." 


Initialization 


DFHTBP is invoked by the system initialization program (SIP) in an 
emergency restart situation after the recovery utility program (RUP) has 
completed its processing. The function of RUP is to identify all in¬ 
flight tasks and their associated log records from the CICS/VS system 
log. RUP writes this information to the restart data set. 

During the initialization phase, DFHTBP reads, from the restart data 
set, the transaction backout table, the message backout table, the file 
backout table, and the DL/I backout table. 

The transaction backout table contains an entry for each in-flight 
task that accessed a recoverable resource, or caused journal records to 
be written to the system log prior to an abnormal termination of 
CICS/VS. DFHTBP does not use the contents of the table, but does make 
it available to user exits. 

The message backout table contains an entry for each in—flight task 
involved in the sending or receiving of recoverable terminal messages or 
that caused journal records representing terminal messages to De written 
to the system log prior to an abnormal termination of CICS/VS. Further, 
an entry is created for each task that had terminated and the delivery 
of its final output message was in—doubt (a definite response had not 
been received and logged by CICS/VS) prior to the system failure. 

DFHTBP verifies that the terminals identified in the message backout 
table exist in the terminal control table used for the current execution 
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of CICS/VS. The address of the corresponding TCTTE (if present) is 
placed in the table entry, or the table entry is flagged as “absent” and 
that no action is to occur. 

The file backout table contains an entry for each in—flight task that 
accessed a recoverable file or caused journal records representing file 
activity to be written to the system log prior to an abnormal 
termination of CICS/VS. DFHTBP verifies that the files identified in 
the file backout table exist in the file control table used for the 
current execution of CICS/VS. The address of the corresponding FCT 
entry (if present) is placed in the file backout table entry, or the 
entry is flagged as “absent” and that no action is to occur. DFHTBP 
also checks the initial status of the files as described in the FCT 
entries (that is, deferred open, disabled, and so on) and flags the file 
backout table entries to indicate which temporary status changes are 
required during data base backout processing. 

DFHTBP writes a list of "absent" file IDs to the transient data 
destination “CSMT" and also displays the same list on the console with 
either a “GO" or a "CANCEL” option. 

If "GO" is selected the user initialization exit is given control, 
and the user may examine the four tables above and may mark any 
additional entries for “no action.” Upon return from this exit, DFHTBP 
performs the temporary status cnanges for all files requiring action 
(including opening deferred—open files and so on) and proceeds to read 
the data records placed on the restart data set by RUP. 

The DL/I backout table contains an entry for each in—flight task that 
was scheduled for DL/I resources. DFHTBP first verifies that the PSBs 
in use by these tasks exist in the PSB directory and that they can be 
scheduled. Then the DM3s that are referenced by the above PSBs are 
checked in the same way in the DMB directory. If a PSB or DHB is not 
found, or cannot be scheduled, an indication is set in the DL/I backout 
table entry and the entry is marked for “no—action.” If a data base is 
marked for "deferred open" in the file control table, the DL/I backout 
table entry is flagged and the data base name is kept in a list. 

DFHTBP writes a list of missing and/or unschedulable PSB and/or DNB 
names to the transient data destination "CSHT", and also displays the 
same list on the console with either a “GO" or “CANCEL" option. 

When each data record is read, (if xt is not a record that was 
written to the log by DL/I) it is passed to the user input exit where 
the user may examine it, process journaled records as required, and 
select appropriate DFHTBP processing options upon returning. The 
records are presented to the exit in a LIFO sequence, that is, in the 
same sequence as they appeared on the system log when read backward by 
RUP. After the last data record has been processed, DL/I backout is 
performed and DFHTBP gives control to a user termination exit. Upon 
return, DFHTBP terminates. 

The next four sections describe the data base backout, temporary 
storage backout, DL/I backout, and message recovery processes performed 
by DFHTBP. The system programmer should realize that the selection of 
which process is performed is basea upon the type of data record read 
from the restart data set. Those representing file control program 
activity are processed for data base backout. Those representing 
storage program activity are processed for temporary storage backout, 
while those representing DL/I activity are processed for DL/I backout. 
Those representing terminal control program activity are processed for 
message recovery, and all other records are ignored by DFHTBP. 

Transaction backout runs under the control of terminal control*s task 
control area (TCA). If insufficient storage is available for 
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transaction backout (causing the short—on-storage condition to occur) , 
terminal control*s TCA may be suspended and the system will stall. It 
is, therefore, in the interest of all users to ensure that sufficient 
storage is available for emergency restart to be performed without 
causing the short-on-storage condition. 


Data Base Backout 


The default data base backout processing performed by DFHTBP involves 
restoring the contents of recoverable files altered by in-flight tasks 
prior to a system failure. Records contained on the restart data set 
were written to the system log by the file control program when task 
activity altered the contents of recoverable files (as specified by 
LOG=YES when generating the FCT entries). The following chart details 
the type of activity written to the system log and how DFHTBP backs out 


that activity for in—flight tasks. 

GET only 
GET-UPDATE 

PUT-UPDATE 

PUT-NEWREC 


Online Operation 

Not logged. No backout is 
required. 

The before—copy of the record is 
logged. This copy is reapplied 
to the file. 

Not logged, because the preceding 
online GET—UPDATE is logged and 
used by DFHTBP for backout. 

The ID and data of the added 
record are logged, although only 
the ID is used by DFHTBP to delete 
the record for VSAM KSDS files. 


For ISAM, BDAM, and VSAM ESDS files, 
no delete function exists. In these 
cases, the user file error exit is 
given control if a record exists. 
However, if a preceding GET—UPDATE 
issued by DFHTBP results in a 
•no—record—found• condition, the 
add did not take place, and no backout 
is required. 

| PUT—DELETE (VSAM KSDS and Not logged, because the preceding 

| RRDS only) online GET—UPDATE is logged and 

used for backout. To back out, 
a GET—UPDATE is issued by DFHTBP. 

If it fails, a PUT-NEWREC is issued 
to reapply the GET—UPDATE logged 
record. 


| DELETE (VSAM KSDS and This is treated as a GET-UPDATE, 

| RRDS only) PUT—DELETE combination. 


In addition to the user input exit, a file error exit is provided in 
support of data base backout. This exit is given control in the event 
of errors being encountered during the default data base backout 
processing. The same exit is given control to allow the user to 
participate in the deletion of records added to ISAM, BDAM, and VSAM 
ESDS data sets. The exit can logically "mark 11 the record as "deleted” 
according to application—dependent protocols. Upon return from the 
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exit, a PUT—UPDATE is issued by DFHTBP to reapply the "marked" record to 
the file. 

A successful execution of DFHTBP is dependent upon how the system is 
generated and how it is initialized. The file control program pFHFCP) 
should be generated to support all needed functions (for example, VSAM 
DELETE if VSAM additions are to be backed out). The FCT should also be 
generated to allow •reverse 1 operations on data sets where updates have 
taken place and the same FCT is used when emergency restarting. 

However, if the FCT does not allow operations needed to back out, DFHTBP 
will temporarily change the FCT so that the operations can take place. 
This is done after the user—initialization exit, so that if the user 
does not want this to take place, the appropriate file backout table 
entry can be marked for ”no action 11 in the exit. 


Temporary Storage Backout 


DFHTBP participates in the recovery of auxiliary temporary storage by 
backing out the effect of ••replace 11 requests made to recoverable 
temporary storage destinations by tasks that were in—flight at the time 
the system was interrupted. The remaining temporary storage recovery 
process is performed by the temporary storage recovery program 
(DFHTSRP) . 

Temporary storage ”PUT (Q)—REPLACE” requests to recoverable 
destinations (defined in the TST), cause the contents of the records 
being replaced to be recorded to the system log. The user input exit is 
given control before DFHTBP processes the record, where the user may 
elect to have the recorded data ignored. The default temporary storage 
backout processing causes the before-copy of the record to be reapplied 
through a ”PUT (Q)—REPLACE” request. This effectively restores the 
original record in temporary storage. 


M essage Recovery and Resynchronization 


CICS/VS support of message recovery and resynchronization is restricted 
to logical units, and is dependent upon the online capabilities of the 
specific devices involved in the exchange of message traffic. The 
CICS/VS VTAM terminal control program (DFHZCP) performs the online 
logging operations associated with message recovery and 
resynchronization. Message recovery requirements and/or options are 
specified for the transactions in the program control table (PCT)• When 
a task is initiated, CICS/VS verifies that the message requirements 
specified for the task can be satisfied by the logical unit to which the 
task is connected, before allowing the task to run. The message 
recovery and resynchronization process described here assumes that the 
terminal can support a task*s characteristics of PROTECT in its message 
option group (see "Program Control Table” in Chapter 3.2 of this 
manual). 

The purpose of the message recovery and resynchronization facility of 
CICS/VS is, in case of an emergency restart, to: 

• Support resynchronization of message traffic between CICS/VS and 
logical units that can participate in this function. 

• Make available to the user, the originating input message for in¬ 
flight LUWs and/or the committed output message for the last 
successfully completed LUW for a logical unit. 
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• &ake available for auto ma tic representation to the logical unit, 
the committed output message for the last successfully completed 
LOW whose delivery was in—doubt at the time of the abnormal 
termination. 

Note: Re synchronization and automatic representation are not available 
for 3210 , 3270 compatibility mode, interactive, and 3770 batch logical 
units. All other facilities are available. 


Data Written to System Log 


The following information is written to the system log. 

• For message-originated transactions, the originating input message 
is logged together with resynchronized data (sequence numbers prior 
to task initiation)• The logging is performed by the start-up—task 
subroutine in ZCP. This logging is performed so that, in case of a 
system breakdown before the task completes (and logs) an LUW, this 
message can be collected during the backward scan of the log and 
made available to the user. The resync data is used to 
resynchronize message traffic with the logical unit. 

• The first input message for a LUW (after a preceding sync point) is 
logged together with resynchronized data. This is done by the 
application request routine in ZCP. The reason for this logging is 
the same as above. 

• For transactions which are not initiated by transactions, resync 
data only is logged by the ZCP start—up—task subroutine. This 
logging is performed so that, in case of a system breakdown before 
tne task completes (and logs) a LUW, this resync data is used to 
resynchronize message traffic with the logical unit. 

• For any outstanding write operation, at sync point time, the output 
message and resync data are logged. The logged message can be 
identified as requiring (or not requiring) definite response. If 
it requires a definite response, it is defined as a committed 
output message. This logging is performed so that, in case of a 
system breakdown sometime in the next LUW, DFHRUP will, during the 
backward scan of the log, collect this message and make it 
available to the user. Thus, the user has access to the last 
output message for a completed LUW. However, if this sync point 
was caused by a task detach, and was successfully logged, the 
message is not collected unless it is a committed output message 
for which a definite response is absent on the log. Resync data is 
used only if the message is collected. 

• For tasks that do not have any outstanding write operation at sync 
point time, only resync data is logged. The reason for this 
logging is to be able to resynchronize message traffic with the 
logical unit even though no message is part of this LUW. 
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• For committed output messages, the receipt of the required response 
is logged. 

If the preceding sync point was caused by task detach, and thus the 
TCA has been freed, the logging is performed by a special task 
attached by ZCP. 

If the preceding sync point was caused by a user request, the 
response logging is performed by the sync point subroutine in ZCP 
under the user TCA. The response is logged so that, if a system 
breakdown occurs before a response is logged, the in-doubt 
committed output message can be collected and made available to the 
user. 

• The periodically taken activity keypoint includes data to be used 
for message recovery and resynchronization. The data keypointed 
includes TCTTE identifications of logical units waiting for 
responses to committed output messages. 

The reason for this logging can be explained as follows: 

Suppose a task ends with a logging of a committed output message as 
part of its last sync sequence (an activity keypoint is then 
recorded on the log) and a system breakdown occurs before the 
response is logged. The keypoint tells DFHBUP to continue the 
backward scan and collect the in—doubt committed output message for 
possible representation later. 

The default message recovery processing performed by DFHTBP examines 
each ZCP—created system log record retrieved from the restart data set 
if logical unit recovery action is to be taken. The presence of any 
message indicates that resynchronization with the logical unit is to 
occur. HUP has primed the appropriate message backout table entries 
with the resync data (sequence numbers). DFHTBP moves this information 
to the corresponding TCTTEs and sets indicators showing that the logical 
unit is in an emergency restart status and that resynchronization should 
occur. 

A copy of each ”in—doubt” committed output record read by DFHTBP is 
written to a temporary storage 9, resend slot” with the data—ID of 
DFHZxxxx (where ”xxxx” is the symbolic terminal ID). HUP identifies 
messages whose committed output is fl in—doubt” by setting an indicator in 
the appropriate record. The messages in the “resend slots* 1 are 
available when the logical unit connection has been reestablished and 
the results of resynchronization indicate a particular ”in—doubt” 
message was not received and, therefore, should be retransmitted. 

DFHTBP sets an indicator in the appropriate TCTTE showing that an "in¬ 
doubt” message has been saved for representation. Bach ”resend slot” 
can only contain one message and is in the standard journal control 
record format. 

A copy of each committed output record (whether ”in—doubt” or not) 
and each initial input message for an in—flight task*s LUW is written to 
a temporary storage message cache of DFHMxxxx (where ”xxxx” is the 
symbolic terminal ID). The messages in each message cache are available 
for user examination and are intended as an aid in determining which 
activity had completed and/or was backed out as a result of a CICS/VS 
system failure. Bach message cache can have multiple entries, and can 
contain the results of multiple emergency restart situations. They are 
temporary storage queues and it is the user*s responsibility to release 
their contents. The records are standard journal control record format. 
The following summary recaps the combinations of records that can appear 
in each message cache for each emergency restart situation. 
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• A single "in—doubt" committed output record ("in—doubt" identified 
in the system prefix of the Journal control record) indicates that 
the LUW represented by the message had completed, but that delivery 
of the message was in-doubt at the time of the system failure. 

This message is also saved in a "resend slot." The task either 
terminated, or was awaiting receipt of the response and, therefore, 
had not started a new LOW. Resynchronization uses the sequence 
numbers at the time this message was initially sent. 

• A single "not—in—doubt" committed output record indicates that the 
LUW represented by the message had completed, and that delivery of 
the message had been confirmed prior to the system failure. The 
message itself may reflect which activity should be started next, 
as well as which activity has been completed. The task, however, 
had not terminated and may have started a new LOW which was backed 
out. In this case the task had not requested terminal input during 
the new LOW (typical for output—only type tasks with multiple 
LOWS). Resynchronization uses the sequence number at the time the 
response was logged. 

• A single initial input record indicates that the task was in—flight 
and, therefore, the interrupted LOW was subject to backout during 
emergency restart. The task was either in its first LOW, or if it 
had completed a prior LOW, there was no final output message 
associated with the prior LOW (typical for input—only type tasks 
with multiple LOWs). The message itself may reflect which activity 
was backed out and may indicate that the process should be 
reinitiated by the user later. Resynchronization uses the sequence 
numbers prior to the time the message was received (those as of the 
last successful completion of a prior LOW of this or a prior task 
having message recovery support). 

• An initial input record followed by a "not—in—doubt" committed 
output record indicates that the task was in—flight and, therefore, 
the interrupted LOW was subject to backout during emergency 
restart. This is based on the presence of an initial input record. 
The presence of the committed output record indicates the task had 
started a new LOW and the prior LOW associated with the committed 
output record had completed successfully. Both messages may 
reflect which process should be reinitiated by the user later. The 
two records are in the sequence described above, which is the 
sequence in which they appeared on the system log when read 
backward by ROP. Resynchronization uses the sequence numbers at 
the time the response to the committed output was logged. 

Journaled records representing message input and/or output are 
ignored by DFHTBP. However, their presence will cause resynchronization 
to be scheduled when the terminal connection is reestablished. 
Resynchronization uses the sequence numbers as of the completion of a 
prior task having message recovery support, if the task causing the 
records to be written did not have message recovery support. 


Transient Data Recovery 


Intrapartition transient data destinations (specified in the DFHDCT 
TYPE-IWTRA macro) may be defined as recoverable in order to permit 
rebuilding in the event of abnormal system termination (that is, of the 
partition, of CICS/VS, of the operating system, or of the transaction). 
Information is recorded on the system log in order to effect recovery. 
The type of recovery specified determines the status to which the 
destination and DCT entry will be restored. 
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If a destination is defined as physically recoverable (DESTRCV=PH), a 
record is written on the system log using information from the 
destinations DCT entry upon first PUT to the gueue, on every GET, and 
prior to a RELEASE or PURGE. Upon emergency restart of CICS/VS 
following an abnormal system failure, the DCT entry for a physically 
recoverable destination is restored to reflect the physical status of 
the destination in the event of abnormal termination. The queue is not 
under exclusive control of the task; therefore data from other tasks may 
be interspersed in it. If the destination was being written, all 
records will remain intact, that is, after recovery the DCT will point 
to the next record on the queue to be written. If the destination was 
being read, the DCT will be restored so that the first record to be read 
following recovery will be the last record that was read prior to 
abnormal termination. 

If a destination is defined as logically recoverable (DESTRCV=LG) , a 
record is written on the system log using information from the DCT entry 
at a sync point, which delimits a logical unit of work (LUW) which is 
that point in a task's execution when a complete transactional function 
has been performed. It may occur at the end of a task or may be 
explicitly defined in the transaction through the DFHSP TYPE=USER macro 
instruction). The queue is under the exclusive control of the task. 

The first task to access the queue will enqueue upon the destination 
and thus "own 11 it for the duration of the task. Two tasks may enqueue 
upon the destination if one is reading and the other is writing. This 
prevents interspersing data from multiple tasks and allows transaction 
backout of transient data. Upon emergency restart or dynamic 
transaction backout of CICS/VS following an abnormal system failure, the 
DCT entry is restored to reflect the logical status of the queue as it 
was at the last sync point prior to abnormal termination. This means 
that any GETs or PUTs to the queue made by a transaction which was in¬ 
flight (had not completed) at the time the system or the transaction 
abnormally terminated, or which terminated itself abnormally and for 
which dynamic transaction backout was specified, will be backed out 
automatically either at the time of the transaction failure or when the 
system is emergency restarted after a total system failure. An input 
destination is restored to the status which existed at the completion of 
the last task which had read from it. An output destination is restored 
to the status which existed at the completion of the last task which had 
written to it. 


DL/I Backout 


After data base backout, temporary storage backout, and message recovery 
have been performed, DFHTBP will backout the effects of the in—flight 
tasks against DL/I data bases based on the PSBs that were scheduled at 
system failure. This is done one PSB at a time. First, a "PCB" call is 
issued to schedule the PSB, then records are read from the restart data 
set. Each record that relates to the PSB is passed to the DL/I backout 
| module (DFSRDBCO for OS/VS or DLZRDBCO for VSE) to do the physical 
backout. When all records have been read from the restart data set, a 
••TERM" call is issued to unschedule the PSB, and processing continues 
with the next PSB in the DL/I backout table. 

A DL/I error exit is provided in support of DL/I backout. This exit 
is given control in the event of errors occurring while DL/I backout is 
being attempted. These errors include those encountered during PSB 
scheduling and unscheduling, as well as those encountered while 
attempting physical backout. 
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g ser-written Exits for the Transaction Backout Program 


User exits provided by DFHTBP are not included through the standard 
methods used for other CICS/VS management modules (see Chapter 6.2 of 
this manual)• Because of its specialized processing nature during an 
emergency restart, DFHTBP user exits must conform to some conventions 
not applicable to other management module exits. 

Each user exit in DFHTBP is invoked through a BALE R14,R14 
instruction. Each exit must save all registers temporarily (in the CSA 
is acceptable), must finally establish its own base register, and must 
finally move the saved registers from the CSA to a 64—byte save area 
defined in the exit logic itself. This form of non—reentrant coding is 
acceptable, because DFHTBP is not executed in a multitasking 
environment. The following is a recommended coding technique for the 
exits written for DFHTBP: 


START 

DS 

OH 

First statement in exit code 

ENTRY 1 

• 

• 

DS 

OH 

Exit entry point 


STM 

0,15,CSA0SBSA+8 



BALE 

R1,0 



USING 

*,R1 



L 

R1,=A (START) 



USING 

START,R1 



MVC 

• 

SAVEREGS,CSAOSRSA+8 



• 

LM 

0,15,SAVEREGS 



BR 

• 

R 14 

Return to DFHTBP 

ENTRYn 

• 

DS 

• 

OH 

(Repeat above for each 


# 


exit entry) 


DS 

OF 

(Alignment) 

SAVEREGS 

DS 

• 

XL64 

save area 


• 

• 

LTORG 


Last statement in exit code 


END 

DFHTBPBTA 

Last statement in DFHTBP 


| Registers R12, R13, R14, R5, and R6 contain the addresses of the TCA, 
| CSA, DFHTBP return point, and DFHTBPs initial base registers 

respectively, upon entry to any DFHTBP user exit. Other registers may 
contain specific information depending on the particular exit. These 
are covered individually in the following text as the exits are 
discussed. 

The user has access to all other CICS/VS services, except terminal 
control services, during exit execution. However, the following 
restrictions should be considered: 

• An exit must not release, or cause to be released, any file control 
area pointed to by the register FWACBAR as a result of DFHTBP 
processing. 
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• If an exit causes an area to be acquired as a result of a file 
control request, it is the responsibility of the exit to cause the 
release of that area. 

• An exit must not attempt to make any file control requests to a 
VSAM data set with a string number of one (1), unless »no action” 
has been specified for that file during the user's initialization 
exit. 

• The processing of DFHTBP and its exits is performed under the 
control of terminal control^ TCA. Therefore, any service request 
must not cause the task to be suspended (an interval control WAIT, 
for example, will cause the system to terminate abnormally). 

• Task chained storage acquired in an exit will be released at the 
completion of emergency restart processing. However, the exit 
should attempt to release the storage as soon as its contents are 
no longer needed. 

• No exit should reset either the ”absent” or ”no action” indicators 
set by DFHTBPi. 

• Only the initialization/termination exit can set the "no action 11 
indicators in the file, message, or DL/I backout table entries. 

Refer to Chapter 6.2 for instructions on supplying the entry 
addresses for these exits. 

Four user exits are provided: 

1. The initializ a tion/termination exit is given control on three 

different conditions, each identifiable by appropriate reason codes 
in the communication byte TBXITCOM. 

a. Table initialization — Four tables have been read from the 
restart data set: the transaction backout table (DSECT 
DFHTBODS) is pointed to by the field TBTBOAD; the file backout 
table (DSECT DFHFBODS) is pointed to by TBFBOAD; and the 
message backout table (DSECT DFHMB0D5) is pointed to by 
TBMBOAD; and the DL/I backout table (DSECT DFHDBODS) is pointed 
to by TBDBOAD• The entries in the file, message, and DL/I 
backout tables have been verified against the loaded file 
control table, terminal control table, and DL/I PSB and DMB 
directories respectively, and marked as ”absent” and ”no 
action” if unmatched. Also the file and DL/I backout table 
entries have been flagged if temporary status changes are 
required during bacxout processing. DSECTs for the FCT and 
TCTTE have been provided in DFHTBP. TBXITCOM is set to 
TBINITTP indicating initial table processing. The exit may 
scan the various tables, marking additional file and message 
backout table entries for M no action.” Upon return from the 
exit, DFHTBP will open the files and make the temporary status 
changes, unless “absent” or ”no action” is indicated for the 
entries. Prior to giving control to the exit, DFHTBP has 
written a list of "absent” file IDs and missing or 
unschedulable PSB and DMB names to the »CSMT” transient data 
destination and to the console operator with a "GO” or "CANCEL” 
option. The exit is only given control if the "GO” option is 
selected. 
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b. Open errors — The exit is given control if an error occurs 
while opening a file control data set. In this case, TBXITCOM 
is set to TBINITOE, and the symbolic register FBOREG points to 
the file backout table entry for which the error occurred. A 
message has been written to CSMT and to the console operator 
with a «G0 ,f or "CANCEL" option. The exit is only given control 
if the "GO" option is selected. Upon return from the exit, the 
file backout table entry is marked "no action" by DFHTBP• 

c. Termination — The exit is again given control just prior to 
terminating DFHTBP. The communication byte TBXITCOM is set to 
TBTERMIN. The addresses of the various tables previously 
described under "Table Initialization" are still available to 
the exit. Upon return from the exit, DFHTBP will restore the 
temporary status changes made and close or disable any 
appropriate files (unless "no action" is indicated). DL/I data 
bases, if specified as deferred in the FCT, will be closed. 

The initialization/termination exit must always return to DFHTBP 
through a BE 14 instruction (there are no processing options 
available to this exit). 

If no initialization/termination exit is provided, DFHTBP will 
continue with its normal processing. 

The input-exit is given control each time a record (other than a 
DL/I record) has been read from the restart data set. At that 
time, the symbolic register JCRREG points to the record, which 
should be addressed by using DSECT DFHJCRDS. The type of record 
can be determined by testing field JCRSTRID with the symbolic codes 
provided by "DSECT" DFHFMIDS• In case of a record written by the 
file control program, the symbolic register FBOREG points to the 
corresponding DFHFBO—entry. In case of a record written by the 
terminal control program, the symbolic register MBOREG points to 
the corresponding DFHMBO—entry. The communication byte TBXITCOM is 
not applicable in the input—exit . 

If the default action by DFHTBP is desired upon return from the 
input—exit, return should be made through a B 0(,R14) instruction. 
If no action is desired, return should be made through a B 4(,R14) 
instruction, in which case the record area will be freed 
immediately and a new record will be read. 

The default DFHTBP actions are: 
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For user journaled records: 

For automatic journaled 
records: 

For logged records applying 
to files or terminals flagged 
for 11 no action”: 

For logged ”read—updates”; 


For logged "write—add”: 


For logged temporary storage 
"POT (Q)—REPLACE”: 


For logged terminal messages: 


No action 


No action 


No action 

Beapply before—copy of 
the record to the file. 

The user*s file error 
exit (see below) is 
given control for ISAM, 
BDAM, and VSAM ESDS files. 
For VSAM KSDS files, the 
default action is to delete 
the record. 

Reapply the before copy of 
the record to temporary 
storage. 

Save the records in the 
temporary storage ”resend 
slot” and/or "message 
cache” as appropriate. 


3. The file—error—exit is given control when some error condition has 
been returned from the file control program during the backout 
processing or if an error has been detected by DFHTBP itself. 

Symbolic register JCRREG points to the record read from the restart 
data set, and should be addressed using DSECT DFHJCRDS. Symbolic 
register FBOREG points to the corresponding DFHFBO entry. Except 
as indicated below, the file-error—exit has no processing options 
and should return to DFHTBP through a BR14 instruction. The 
| communication byte TBXITCOM is primed for different type of errors 

as follows: 

TBFEGD 

If an error response is returned from FOP while servicing a 
GET-UPDATE—request. DFHTBP has attempted to retrieve the 
existing copy of the record prior to backing it out. The 
file control CHECK macro in combination with the type of 
record pointed to by JCRREG (”before-copy” of a read—for— 
update record, or ”new—copy” of a "write—add” to be 
deleted) can be used in the exit to determine the specific 
problem. 

TBFELE 

If the FWA acquired from FCP is not big enough to receive 
the before—copy data from the restart data set to perform 
the backout. The symbolic register FWACBAR points to the 
FWA on entry to the exit. The file control CHECK macro is 
not applicable to this error. 

TBFEPtJ 

If an error response is returned from FCP while servicing a 
PUT—UPDATE—request. DFHTBP has attempted to replace the 
existing copy of the record on the file with the ”before- 
copy” pointed to by JCRREG. The file control CHECK macro 
can be issued in the exit to determine the specific error. 
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TBFEPN 

If an error response is returned from FCP while servicing a 
PUT—NEW—request. DFHTBP has attempted to add the "before— 
copy 11 of a deleted VSAM—KSDS data set record. The file 
control CHECK macro can be issued in the exit to determine 
the specific error. 

TBFEWA 

If the record read from the restart data set is a WRITE- 
ADD , the record is also read in from the file through a 
GET-UPDATE. For ISAM, BDAM, and VSAM-ESDS data sets, no 
delete function exists. The user is given the opportunity 
to "mark" the existing record on the file as deleted 
according to application—dependent logic. The FWA—version 
of the record should be marked. If the user wants the FWA 
version to be reapplied, return should be made through a B 
0 (,R14) instruction. If the user does not want this, but 
would rather bypass the operation, return should be made 
through a B 4(,R14) instruction. 

Symbolic register FWACBAR points to the FWA containing the 
existing record on the file. The file control CHECK macro 
is not applicable to the error. 

TBFEVD 

If an error response is returned from FCP while servicing a 
VSAK—DELETE reguest. DFHTBP has attempted to delete a new 
record added to a VSAM—KSDS data set. The file control 
CHECK macro can be issued in the exit to determine the 
specific error. 

The DL/I error-exit is given control when any error is encountered 
during DL/I backout. These errors include attempting to schedule, 
or unschedule, a PSB as well as those encountered during physical 
backout. 

Symbolic register DB OR EG points to the corresponding DFHD30 entry. 
The area labeled READAREA contains the log record (if any). The 
communication byte TBXITCOM is primed for different types of errors 
as follows: 

TBDBUNSC 

If an error is returned from DL/I while attempting to 
schedule a PSB. 

TBDBUNBO 

If an error is returned from the DL/I backout module 
(DFSRDBCO for OS/VS or DLZRDBCO for VSE) while attempting 
physical backout. 

TBDBUNTR 

If an error is returned from DL/I while attempting to 
unschedule (terminate) a PSB. 

The exit is given control to determine whether the error should be 
ignored. The default action upon return from the exit is to 
sustain the error by writing a message to transient data 
destination CSMT and to the console operator with a "GO" or 
"CANCEL” option. If the "GO” option is selected, the error is 
ignored and processing continues. If the default action is to be 
taken, return should be made through a BR R14 or a B 0(,R14) 
instruction. If the exit determines that the error is to be 
ignored, return should be made through a B 4(,R14) instruction. In 
this case, processing will continue with no messages sent to 
transient data destination CSMT or to the system console. 
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TEMPORARY STORAGE EMERGENCY RESTART 


Temporary storage emergency restart provides for recovery of auxiliary 
temporary storage data following an abnormal termination of CICS/VS. 
During an emergency restart, CICS/VS will restore the control blocks for 
data placed on auxiliary temporary storage during the previous 
execution. The user has the option of specifying which auxiliary 
temporary storage is to be recoverable by generating a table (TST) which 
is referenced during normal operation. The table contains the leading 
characters of DATAIDs for which recovery processing is to be performed. 
This provides the capability of designating generic classes of data to 
be recovered following abnormal termination. In addition, temporary 
storage emergency restart provides for backing out changes made to 
recoverable data by in-flight transactions at the time of abnormal 
termination. 

Interval control data recovery, an integral part of auxiliary 
temporary storage emergency restart, ensures that data placed on 
auxiliary temporary storage by an interval control PUT request, is 
restored and that the transaction originally scheduled to process that 
data is rescheduled following abnormal termination. This means that 
data scheduled for processing at some future time will be restored and 
processing rescheduled during emergency restart. 


PROCESSING TRANSACTION BACKOUT DATA 


CICS/VS provides the user with the transaction backout program in 
support of data base recovery, or the user can write his own support. 
This section provides some guidelines for users who wish to perform 
their own data base recovery. 

During an emergency restart, the system log is automatically 
repositioned after the last record written during the previous 
execution. The recovery utility program (DFHRUP) reads this data set 
backward in order to process system recovery data and to collect user 
recovery backout data. The backward scan is completed and more user 
records cannot be collected when the following conditions are met: 

• At least one complete activity keypoint (delimited by end and start 
of keypoint records) has been retrieved. 

• The start of all logical units of work (LUWs) which were in—flight 
at system abend time have been reached. 

• Committed output messages logged for recovery purposes have been 
collected from the previously completed LUWs. 

During the backward scan, DFHRUP outputs the following data to the 
restart data set: 

• Records output to the system log by tasks (LUWs) that did not 
complete processing before the system abnormally terminated (that 
is, in—flight tasks). These records follow the standard journal 
control record layout, have the flag JCSPRRIF set ON in field 
JCSPF1, and are as follows: 

— Records automatically logged by the file control program for 
data sets with the specification LOG=YES in the FCT• 
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— Records automatically journaled to the system log by the file 
control program (PCP) , according to the user—specifted option 
in the FCT• 

— Records automatically logged or journaled to the system log by 
the terminal control program for tasks defined in the 
appropriate PCT entries. These records should be ignored for 
data base recovery. 

Rote ; The field JCRSTRID in the prefix area indicates the type 
of record, and the DFHFHIDS should be copied into user programs 
reading these records. It contains the symbolic codes for the 
the type of record. For a more detailed description of these 
records, see "Layout and Contents of Journal Records" in 
Chapter 4.6. 

— Records written to the log by DL/I. These records do not have 
the normal CICS/VS log record prefix. The first byte of the 
field JCRSTRID will be non—zero and less than X^O 1 . 

— User—journaled records to the system log that were output by 
in-flight tasks. 

Rote: User—journaled records with the high—order bit set ON in 
the JTIPEID and which are encountered during the backward scan, 
are copied over to the restart data set regardless of the 
status of the task (in-flight or complete)• If the task was 
completed, the flag JCSPRRIF is OFF in field JCSPF1• User- 
written activity keypoint records in the last completed 
activity keypoint are always copied to the restart data set. 
User activity keypoint records in other completed keypoints 
that are encountered in the backward scan of the log are only 
copied if the high-order bit in JTIPEID is on . 

The transaction backout control record contains an entry for each 
task in-flight at the time the system abnormally terminated. The 
entries are defined by the DFHTBODS DSECT, which should be copied 
into the user program. 

There are two types of entries in the transaction backout control 
record: 

— In-flight tasks — These are tasks that have caused records to 
be written to the system log, but failed to complete before 
system failure. No special start—of—task record is written to 
the system log, but the first record logged for the task is 
flagged as being start-of—task. When DFBRUP reads the log 
backward, and the first record found for a task is one other 
than an end-of—task record, this task is considered in-flight. 
DFHRUP must then find the corresponding start-of-task 
indication to complete the collection of recovery backout data 
for this task. Long running tasks should be divided into LUWs 
by means of the DFHSP macro instruction (as described in the 
CICS/YS Application Programmers Reference Manual (Macro 
Level) ). In this case, the start and end of task are logical, 
thus reducing the backward scan necessary for DFHRUP. 

— Active tasks — These are tasks that did complete a LUW and 
started another, but did not cause any records to be written to 
the system log during this LUW. Thus, during DFHRUP 
processing, a completion of a LUW was found, but no p hysical 
end-of—task (that is, task DETACH) was found. 
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DFHKP Macro Instructions 


The following DFHKP macro instructions are provided for users who wish 
to perform their own methods of data base recovery. The macro 
instructions are: 


• DFHKP TYPE-RTBOCTL — to read a transaction backout control record 
into storage. 

• DFHKP TYPE=RTBODATA — to read transaction backout data records. 

• DFHKP TYPE=RTBOEND — to reset the pointer in order to read more 
transaction backout data. 


DFHKP TYPE=CHECK — to check the response to a previous DFHKP macro. 


Read Transaction Backout Control Record 


A macro instruction is provided to read the transaction backout control 
record into dynamic storage as follows: 

i i i - 

| | DFHKP | TYPE=RTBOCTL, 

| | | [,EOFADDR=symbolic—address] 

I | | [,IOERROR=symbolic—address] 

| | | [,NORESP=symbolic—address] 

i-1-1------- 


TYPE=RTBOCTL 

indicates that the transaction backout control record is to be 
read from the restart data set. CICS/VS obtains an area for 
the record and returns the address to the user in the fullword 
field TCAKPDBA. 


EOFADDR=symbolic-address 

specifies the entry label of the user—written routine to which 
control is to be passed if no control record exists on the 
restart data set. 


IOERROR=symbolic-address 

specifies the entry label of the user—written routine to which 
control is to be passed if an unusual event occurs during the 
file operation. 


NORESP=symbolic—address 

specifies the entry label of the user—written routine to which 
control is to be passed if no error occurs. NORBSP signifies 
"normal response." 
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Rea.4 Transaction Backout Data 


The following macro instruction is provided to read transaction backout 
data records: 

-, - 

DFHKP | TYPE=RT30DATA 

| [,EOFADDR=symbolic—address] 

| [,IOERROR=symbolic-address ] 

| [ ,N0RESP=symbolic-address3 


TYPE=RTBODATA 

indicates that the backout data, beginning with the latest 
backout record, is to be read from the restart data set. The 
data is retrieved sequentially in chronologically descending 
order. CICS/VS obtains the area for the record and returns it 
to the user in the fullword field TCAKPDBA. It is the user*s 
responsibility to free the area when it is no longer needed. 


EOFADDR, IOERROR and NORBSP=symbolie—address 

can be specified with this macro instruction or through a DFHKP 
TYPE=CHECK. The meaning of each operand is discussed under 
'•Read Transaction Backout Control Record”, above. 


Reset Transaction Backout Pointer 


The user may read the transaction backout data again by issuing the 
following macro instruction: 


| DFHKP | TYPE=RTBOEND 


TYPE=RTBOEND 

specifies that the user has logically or physically finished 
reading transaction backout data, and the pointer to the next 
backout record is to be reset. After this is done, the next 
DFHKP TYPE=RTBODATA macro instruction to be issued will read 
the first backout record in the restart data set. 


Test Transaction Backout Response 


The format of the macro instruction which may be used to test the 
response to a request for transaction backout data is as follows: 


1 

| DFHKP 

--- ] 

TYPE^CHECK 

i 

i i 

i 

i_i 

[,EOFADDR=symbolie—address 3 
| [,IOERROR=symbolic—address 3 
| [,SORESP=symbolic—address 3 

i - - -.- - 
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TYPE=CHBCK 

indicates that the response to the preceding DFHKP macro 
instruction is to oe checked. 


BOFADDR=symbolic-address 

specifies the entry label in the user-^vritten routine to which 
control is to be passed if an end—of—file condition occurs 
during the file operation. 


IOERROR=symbolic-address 

specifies the entry label of the user—written routine to which 
control is to be passed if an unusual event occurs during the 
file operation. 


NORESP=symbolic—address 

specifies the entry label of the user—written routine to which 
control is to be passed if no error occurs. NORBSP signifies 
"normal response." 


USER ACTIVITY KEYPOINTING 


An activity keypoint is taken periodically in order to record on the 
system log the information necessary to restore recoverable resources 
during emergency restart and to determine which tasks were in-flight at 
the time of the system failure. This function is performed by attaching 
transaction CSKP at a frequency which is a function of output operations 
to the system log. The user can define this frequency at system 
generation or initialization time and can alter this frequency at any 
time during execution. 

The frequency of the activity keypoint and the amount of logging 
performed by in-flight transactions determine the amount of log data to 
be processed at restart time and thus the duration of the recovery 
process. 

The user may include his own keypoint records in the keypoint 
sequence. This is accomplished by a conditional DFHPC LINK request to 
user program DFHUAKP. This program should be used to record a limited 
amount of selected user data (that is, tables to be restored upon an 
emergency restart). It should be written to avoid suspension of the 
keypoint task (that is, program and work areas should be resident) . It 
is recommended that this program issue only CICS/VS journal control 
| functions. Note that the first use of an activity keypoint should not 
| rely on the results of any program in the PIT. In order to perform 
efficiently, the journal control requests should be asynchronous (that 
is, WRITE without WAIT) and with STARTIO=NO, because this system will 
force synchronization by writing a synchronous end of keypoint record 
upon return from the user program. The user should assign his own 
identification (through the JTYPEID operand) with the high—order bit on 
to these records, in order to make them accessible from the restart data 
set in an emergency restart* (For information on retrieving these 
records, see "Processing Transaction Backout Data" above.) 
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Chapter 4.9. Multiprocessor Recovery Procedures 


| For some conditions of partial system failure on an MVS system running 
on an IBM multiprocessor, appropriate system or CICS/VS operator action 
can reduce the disruption of service that online CICS/VS users 
experience. This chapter provides CICS/VS—specific information to 
enable this to be done. The information should be used in conjunction 
with the 0S/VS2 MVS Multiprocessing: An Introduction and Guide to 
Writing Operating and Recovery Procedures . GC28—095 2, manual, which 
provides more detailed information on the topics discussed in this 
chapter. 


FLAWRING 


The key to successful recovery in the event of partial system failure is 
pre-planning. This takes two forms: 

• Configuring the system for availability. This includes ensuring 
that: 


— the manual switching equipment is available so that BTAM/TCAM 
devices can be switched between the processors. 

— the network control program (NCP) for VTAM is symaetricaliy 
attached to the multiprocessing system. 

— the hardware recovery enhancements shippable unit (SU55) is 
installed on MVS so that channel failures are recovered more 
effectively. 

— at least one device can be used as a CICS/VS master terminal, 
whichever processor fails. 

• Recovery procedures, which include: 

— using terminal list tables for groups of terminals (for 
example, all those on a processor or channel), which are 
predefined to CICS/VS to minimize the number of commands to be 
issued. 

— ensuring that the appropriate CICS/VS broadcast capability is 
generated in CICS/OS/VS. 

— using procedures stored in SYS1.PR0CLIB to minimize the number 
of system commands issued. 

— ensuring that the procedures are kept up-to-date as the system 
configuration changes. 

— testing the recovery procedures by simulating errors. 
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DETERMINING THE APPROPRIATE ACTION 


The flowchart in Figure 4.9—1 at tne end of this chapter shows the 
questions that must be answered before the appropriate action can be 
determined. The action boxes, representing specific procedures to be 
followed, are discussed in the sections which follow. Procedures for 
VTAM, BTAM, and TCAM environments are given and apply only to cases in 
which CICS/VS is still running and a terminal is still available for use 
as a master terminal. 


RECOVERY PROCEDURES FOR A VTAM NETWORK 


The CICS/VS master terminal CSMT commands for dynamically opening and 
closing the VTAM ACB enable CICS/VS operation to be independent of the 
VTAM network. That is, CICS/VS need not be shutdown and restarted when 
the connection to VTAM has been broken. 


RECOVERY PROCEDURES FOR A BTAM ENVIRONMENT 


For the purposes of this discussion, it has been assumed that 
asymmetrically connected lines and channel—attached 3270s connected to 
the processor which fails can be manually switched between the 
processors. 

There are two possible situations: 

1. Channel reconfiguration hardware (CRH) is available. This hardware 
allows the remaining processor to access the channels of the 
processor that has failed in a degraded mode. 

2. Channel reconfiguration hardware (CRH) is not available. 


BTAM Recovery with CRH 


The following general procedures should be adapted to the specific 
requirements of the installations: 

1. Broadcast a message to all users connected to the failed processor. 

2. Quiesce all remote I/O by placing all remote lines connected to the 
processor that fails out of service, using CSMT commands. 

3. Manually switch asymmetric lines and local 3270 control units to 
the remaining processor. 

4. Issue VARY PATH commands to the 0S/VS2 Release 2 or later (MVS) 
operating system to cause MVS to use the newly established paths to 
the devices, and to delete the CRH path. 

5. Reenable the lines and place them back in service by using CSMT 
commands. 

6. Place those local 3270s that may be out of service back in service 
by using CSMT commands. 
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B TAM Recovery without CR H 


To effect recovery in a BTAM environment when channel reconfiguration 
hardware is not available, the following procedures should be adapted to 
suit the specific requirements of the installation: 

1. Manually switch the transmission control unit (TCU) and the local 
3270 control units to the remaining processor. 

2. Issue VARY PATH commands to MVS first to cause the operating system 
to use the newly established paths to the devices and then to 
delete the paths that are unavailable. This is only needed to 
prevent MVS from trying to use the paths on the processor that 
failed when it comes back: in service. 

3. Issue CSMT commands to reenable the remote lines that are out of 
service, and place the lines that were switched over oack in 
service. 

4. Issue CSMT commands to place back in service any terminals that 
were placed out of service because of the errors that occurred. 


FURTHER CONSIDERATIONS BTAM RECOVERY 


The CICS/VS terminal list table can be used to reduce the number of 
commands needed to be issued to CICS/VS. This, however, does not solve 
the problem for the set of commands required to manipulate lines. If 
the number of commands is likely to be large, a user—written transaction 
to perform the functions reguired may be appropriate. 

Multiple commands to the MVS operating system can be stored in the 
system cataloged procedures library (PROCLIB) and can be executed on 
demand by a START command. 

The CICS—related IBM program (number 5798 ANK) "CPU Console as CICS 
Master Terminal 11 may be useful to an installation in order to avoid any 
difficulties that may arise if the terminal normally used for master 
terminal commands is a BTAM terminal that is asymmetrically connected to 
the processor that fails. 


RECOVERY PROCEDURES FOR A TCAM ENVIRONMENT 


In the majority of cases, if TCAM fails CICS/VS will also have failed. 

If CICS/VS is still active, the CICS/VS system must be brought down to 
allow TCAM restart to be followed by CICS/VS restart. 

If TCAM does not fail, some devices may no longer be accessible 
because they were asymmetrically connected to the processor that failed. 

Recovery procedures for TCAM are similar to those already discussed 
for a BTAM environment. The major difference is that instead of using 
CICS/VS CSMT commands to perform the quiescing and reenabling of the 
line, the MVS operator commands VARY $$$,0FF TP (to quiesce), and VARY 
$$3,0N TP (to reenable and restart) must be used. These commands can be 
included in PROCLIB members and can be executed via the START command. 
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Chapter 4.10. Program Check 


When a serious error such as a program check occurs ia a CICS/VS 
partition, the operatiag system abnormally terminates all processing in 
that partition unless the error can be corrected or ignored. The error 
recovery action can be taken by a program in the partition, provided 
that the operating system has been given the address of this program 
before the error occurs* In CICS/VS, the address is that of the system 
recovery program (SRP) and is specified during system initialization. 
The function of the system recovery program is to gain control when an 
error in a CICS/VS partition threatens to terminate all CICS/VS 
processing. The system recovery program then determines whether to: 

• Recover from the error and avoid shutdown by terminating the 
CICS/VS task in error, or 

• Take action during the shutdown to help correct the error and make 
a quick restart possible. Generally, this action consists of 
recording information useful in a CICS/VS restart. 

The system recovery program is functionally divided into two parts: 

• Program check recovery 

• Partition abend recovery. 

To handle program checks the operating system returns control to the 
program check section of the SRP, which may then either: 

• Abnormally terminate the CICS/VS task in error with the code ASRA. 

• Abnormally terminate all CICS/VS processing* 
depending on tests which the SRP applies. 

Details on how to generate the system recovery program can be found 
under DFHSG PROGRAM=SRP in Chapter 2.2 of this manual. 
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Part 5. Devices and Access Methods 




Chapter 5.1. I ntroduction 


This part of the manual contains a discussion on the CICS/VS system 
programmer's role in providing support for various access methods, such 
as the use of VTAM with logical units, and the TCAM (noth SNA and non- 
SNA) interface to CICS/OS/VS. In addition. Part 5 also provides a 
summary of the system generation and table preparation options which 
must be specified to provide support for such devices as the 3270 in 
2260—compatible mode, the 3735, the 3740, and the 3600 on BSC lines. 
Information is also given on how to IPL the System/7. 

Part 5 is organized in the following manner: 


5.2. 

VTAM Logical Units with CICS/VS — which provides a general 
description of system programmer functions available for 
implementing and maintaining CICS/VS features for logical 
units. 

5.3. 

The CICS/OS/VS TCAM Interface — which gives information on 
implementing the TCAM interface to CICS/VS, allowing CICS/VS to 
run as an application program under TCAM. 

5.4. 

Writing A Transaction to IPL The System/7 — which provides 
information on how to write a transaction to IPL the System/7 
on start/stop and BSC lines. 

5.5. 

2260 Compatibility for the 3270 — which describes the system 
programmer's responsibilities for generating the support 
required for running 2260—based transactions from a 3270. 

5.6. 

IBM 3735 Programmable Buffered Terminal — which contains 
information on the system generation and table preparation 
specifications required to generate support for the 3735 
programmable buffered terminal. 

5.7. 

IBM 3740 Data Entry System — which gives similar information on 
the 3740 data entry system. 

5.8. 

IBM 3600 Finance Communication System (BSC) — which gives 
similar information on 3600 BSC devices. 
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In an SNA teleprocessing network, the remote work station is not always 
simply a terminal. Rather, the terminal is typically one of several 
attached to a terminal controller. Furthermore, the terminal controller 
may contain one or more user—written programs. In SNA terminology, 
however, the remote entity with which the CICS/VS application program is 
communicating is always a logical unit. This chapter provides a general 
description of system programmer functions available for implementing 
and maintaining CICS/VS features for logical units. The operands of the 
CICS/VS macro instructions referred to in this chapter are described in 
Parts 2 and 3 of this manual. 

The system programmer should refer to the appropriate CICS/VS 
subsystem guide for a full discussion of the logical unit being used. 
These guides are: 


I • IBM 3270 guide 


• 

IBM 

3600/3630 

Guide 

1 • 

IBM 

3650/3680 

Guide 

1 • 

IBM 

3767/3770/6670 Guide 

1 • 

IBM 

3790/3730 

Guide 


OVERVIEW OF SYST EM PROGRAMMER REQ UIREMENTS 


The system programmer responsible for logical units in a CICS/VS working 
environment has three main divisions of responsibility: 

| • Generating an advanced communications function network control 

| program/virtual storage (ACF/NCP/VS) to control the transfer of 

data between the host processor and the nodes of the logical unit 
| teleprocessing network — The ACF/NCP/VS resides in a 

communications controller. Because CICS/VS does not interface 
| directly with the ACF/NCP/VS, this chapter contains no information 

| concerning ACF/NCP/VS generation. The system programmer must 

consult Introduction to the IBM 3704 and 3705 Communications 
Controllers . 

| • Defining a ACF/VTAM system which supports telecommunications within 

| the CICS/VS subsystems. A brief discussion of the ACF/VTAM 

definition procedure related to system programming functions is 
| presented in this chapter; a general description of the ACF/VTAM 

| definition procedure is given in the ACF/VTAM Concepts and Planning 

manual. 

• Defining a CICS/VS system tnat supports the subsystem hardware 
configuration and desired programming configuration — This chapter 
discusses this requirement, but it describes only the modifications 
and additions to CICS/VS system programming functions that relate 
to CICS/VS subsystem support. 

• Correctly configuring the SDLC terminal controller and writing the 
necessary programs to control the terminals which are attached to 
it and which are to communicate with CICS/VS. 
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| When planning for CICS/VS support of logical units under ACF/VTAM, 
the system programmer must be concerned with the following facilities: 

| • ACF/VTAM support requirements for the logical units. 

• Connection, input, and output services. 

• Basic mapping support (BBS) services for the appropriate devices. 

• The node abnormal condition program (DFHZNAC), the function of 
which is to handle abnormal situations involving a logical unit and 
to allow the system programmer to generate the node error program 
(NEP) to perform error handling. 

• Message option groups (to be referenced by the program control 
table (PCT) entry for a task) which permit certain processing and 
logging characteristics to be associated with a transaction. 

• A terminal control macro interface which provides additional system 
programming capabilities. 

• The option to code user exit—routines to be activated during 
processing of a request by the terminal control management module 
(DFHZCP) . 

• Collection of statistics that can be used for system tuning. 

• Message switching facilities for certain logical units. 

The explanations of these facilities and of related concepts involving 
| CICS/VS system programming responsibilities in a ACF/VTAM network are 
discussed below. 

Chapter 5.3 provides information on system programming 
responsibilities in a TCAM SNA network. 


BASIC CONCEPTS 


The system programmer must understand several new concepts and 
facilities that are basic to his involvement in generating and 
maintaining CICS/VS support of logical units. They are: 

• An additional terminal control program module (DFHZCP) to support 

| ACF/VTAM services. 

| • ACF/VTAM indicators (SNA commands) and responses. 

• The need to communicate with logical units. 


TERMINAL CONTROL PROGRAM DUAL MODULE GENERATION 


| ACF/VTAM is the required access method interface between CICS/VS and 
| logical units. The non—ACF/VTAM terminal control program (DFHTCP) does 
| not provide the required support for ACF/VTAM capabilities; ACF/VTAM 
I support is available only through the CICS/VS ACF/VTAM terminal control 
programs. 

DFHTCP and the ZCP group of programs are two separate collections of 
modules, generated when DFHSG PROGRAM=TCP is specified. They are always 
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assembled separately and loaded separately. The ZCP group ofprograms 
| is always generated, even for a non—ACF/VTAM system, because it contains 
some internal routines which are necessary for the successful operation 
| of DFHTCP. ACF/VTAM support within the ZCP group is generated by 
I specifying ACCMETH=VTAM in the DFHSG PROGRAM=TCP macro instruction; the 
| VTAMDEV operand of this macro instruction controls any device—dependent 
| code that must be generated within the ZCP group for the ACF/VTAM— 

| supported logical units under CICS/VS. The ACCMETH and VTAMDEV operands 
must be specified to provide support for CICS/VS logical units under 
| ACF/VTAM. 

The TCP and ZCP operands of the DFHSIT TYPE=CSECT macro instruction 
specify the suffixes of DFHTCP and the ZCP group, respectively, to be 
loaded by the system initialization program (DFHSIP). If TCP=NO is 
specified, no DFHTCP load is performed. In contrast, specifying ZCP=NO 
does not suppress the ZCP group; this is because, as explained earlier, 

| the ZCP group is always generated with DFHTCP, whether or not ACF/VTAM 
support is subsequently generated. 


| ACF/VTAM INDICATORS 


A CICS/VS interface with terminal control allows the system programmer 
to write routines that request the sending of SNA data flow control 
commands from CICS/VS to the application program of certain logical 
| units. For example, a function provided by a ACF/VTAM indicator may be 
needed in the installation^ error recovery routine (DFHZNEP) . In the 
case of certain logical units, the system programmer should use the 
| indicator interface (DFHTC CTYPE=COMMAND macro) to request a ACF/VTAM 
function, rather than directly alter bits in the TCTTE. Any direct 
changing of bits leads to unpredictable results if any future changes 
are made in the TCTTE internal structure. 

| ACF/VTAM indicators are always sent by CICS/VS with definite 

function—management-end (FME/DR1) response requested, whether they are 
sent on behalf of a system programmer request or a CICS/VS management 
module request. CICS/VS DFHZCP calls the appropriate routine and 
returns control to the requester when the response is received. 

| The ACF/VTAM indicators that are available for use by the system 
programmer are described under DFHTC CTYPE=COMMAND in "Modifying the 
Terminal Control Table 11 in Chapter 6.5 of this manual. 

| ACF/VTAM indicators are also used by CICS/VS management modules. The 
system programmer should thoroughly understand each indicator before 
using it. The system programmer should also understand how and when 
they are used by CICS/VS; misusing any of them can lead to unpredictable 
results. 
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CONNECTION SERVICES 


Before any communication between CICS/VS and the logical unit can occur, 
| CICS/VS must first be connected to ACF/VTAM. The CICS/VS system 
initialization program (DFHSIP) , which is generated in the DFHSG 
| PROGRAM=CSO macro instruction, issues the appropriate ACF/VTAM macro 
instruction to open the CICS/VS access method control block (ACB) to 
| accomplish such a connection. This identifies CICS/VS to ACF/VTAM as 
| one of its application programs. Only then can ACF/VTAM honor a request 
to connect a logical unit to CICS/VS and thus allow communication 
between these two nodes. A logical unit which is connected to CICS/VS 
is said to be owned by CICS/VS for the duration of the connection. 

The CICS/VS APPLID operand provides the name that DFHSIP uses when 
| opening (and closing) its ACB to define itself to ACF/VTAM during 
CICS/VS system initialization or by using the master terminal dynamic 
open facility for the ACB. The system programmer may specify the APPLID 
operand either in the DFHTCT TYPB=INITIAL macro instruction or in the 
DFHSIT TYPE=CSBCT macro instruction, or in both (to permit variable 
generation of the ACB). If the operand is specified in both macro 
instructions, the name supplied through the DFHSIT macro instruction 
overrides that supplied by the DFHTCT macro instruction at CICS/VS 
system initialization; otherwise, DFHSIP opens the ACB using the name 
supplied through the terminal control table (TCT) . Only one APPLID, 
chosen in this manner, is used by CICS/VS per initialization. Any name 
| coded with either APPLID operand must have been defined during ACF/VTAM 
| definition using ACF/VTAM*s APPL statement. 

| In addition, the dynamic close of the ACF/VTAM ACB facility allows 
| CICS/VS to continue, even though ACF/VTAM may not be operational at the 
time. 

| To build the access—method—dependent portions of the TCT for ACF/VTAM 
| support, the system programmer must specify ACCMETH=VTAM with the DFHTCT 
TY?E=INITIAL macro instruction. If ACCMETH is omitted, the current 
| default value is NONVTAM• The former default value of BTAM is, however, 
| still valid. Specification of either NONVTAM or BTAM permits existing 
TCTs to be assembled without change. 

The system programmer controls the connection services available for 
a particular logical unit through the DFHTCT TYPE=TERHINAL macro 
| instruction. ACCMETH=VTAM must be specified to create the necessary 
| ACF/VTAM TCTTE for each logical unit. For each TCTTE, CICS/VS 

automatically creates an accompanying node initialization block (NIB) by 
| issuing the ACF/VTAM NIB macro instruction. The NIB is used to convey 
several operating parameters that apply to the connection being 
| established. These parameters are established during ACF/VTAM 

definition and cannot be altered by the CICS/VS user. The NIBs are 
| grouped apart from the TCTTEs because they are used only by ACF/VTAM to 
process OPNDST reguests, and are not involved during normal logical unit 
| I/O processing* The ACF/VTAM OPNDST request causes ACF/VTAM to 

establish the connection between CICS/VS and the logical unit. This 
connection is called an SNA session and is completed when the logical 
| unit sends a positive response to the SNA BIND command sent by ACF/VTAM 
as the result of the OPNDST request. CICS/VS supplies BIND parameters 
| to ACF/VTAM which are sent with the BIND command. The parameters tailor 
operation of the logical unit to CICS/VS requirements for the duration 
of the session. Different BIND parameters are used by CICS/VS for 
different logical unit types. There is one version of each set of BIND 
parameters in the BIND CSBCT for each different type of BIND used by 
CICS/VS. 

The NETNAME operand of the DFHTCT TYPE=TBRMINAL macro instruction 
provides the symbolic name for the logical unit by which it is known 
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throughout the network:. This is the name which CICS/VS specifies in the 
| NAME operand of ACF/VTAM , s NIB macro instruction to identify the logical 
unit that is represented by this TCTTE in CICS/VS. The same symbolic 
| name must also be defined to ACF/VTAM during ACF/VTAM system definition 
| through the logical unit macro instruction and to the ACF/NCP/VS during 
| ACF/NCP/VS generation* 


LOGON 


| Once CICS/VS has been connected to ACF/VTAM, any logon requests for 

CICS/VS are passed to CICS/VS (unless the MACRF=LQGON operand of the ACB 
l macro instruction was specified during ACF/VTAM definition, in which 
| case ACF/VTAM is not allowed to queue any logon requests for CICS/VS). 

| In general, the CICS/VS logon exit is scheduled by ACF/VTAM in response 
to a request initiated either by CICS/VS or by a logical unit. 

To specify that a simulated logon is to be performed for a particular 
logical unit, the system programmer must specify the CONNECT=AUTO 
operand of the DFHTCT TYPE=TERMINAL macro instruction. When CICS/VS 
| issues the ACF/VTAM SIMLOGON macro instruction in response to a 
CONNECT=AUTO specification, it also supplies the address of the 
particular request parameter list (RPL) which contains tne address of 
the NIB whose NAME field identifies the logical unit for which the 
simulated logon request is to be performed. This drives the logon exit 
logic in DFHZCP to establish connection with the logical unit. If 
CONNECT=AUTO is not specified, the logical unit is not connected to 
CICS/VS at system initialization, but awaits either a master—terminal 
operator connection request, a logical unit logon initiated by the 
| ACF/VTAM network operator, or a terminal operator logon from a logical 
unit. 

CICS/VS logical unit support provides a BELREQ exit—routine so that 
| any other ACF/VTAM applications wishing to use a logical unit currently 
owned by CICS/VS can indicate their needs. When no more work is 
available for the requested logical unit, CICS/VS checks whether it is 
permitted to release it. (The RELREQ operand of the DFHTCT 
TYPRETERMINAL macro instruction defines whether or not a logical unit 
can be released by CICS/VS.) If it can be released, the existing 
connection is broken. 

Conversely, CICS/VS can also request the use of a logical unit 
| currently owned/by another ACF/VTAM application program. For example, a 
SIMLOGON is always performed with the RELREQ and RPL options so that 
| CICS/VS can indicate its need of the logical unit to any ACF/VTAM 
application program that currently owns it. 


INPUT SERVICES 


Input services handle both data from the logical units and asynchronous 
| input such as ACF/VTAM indicators. This section describes CICS/VS data 
| input in general; ACF/VTAM indicators, as they relate to the system 
programmer, are described in “Basic Concepts 11 earlier in this chapter. 

CICS/VS receives user data into the system at two different times. 

The first is when data is entered to create a new user transaction. The 
other is in response to a CICS/VS application program request for data 
from a logical unit. To satisfy these two different situations, CICS/VS 
| uses two distinct kinds of ACF/VTAM RECEIVE macro instructions. 
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To obtain transaction—originating data, CXCS/VS pats all logical 
| units that have no tasks attached into the ACF/VTAM continue—any state. 

| The ACF/VTAM RECEIVE macro instructions with the OPTCD=ANY operand are 
then issued by CICS/VS to allow any data entered by the logical unit to 
be received. The system programmer controls the number of such receive— 
any macro instructions issued, by specifying the number of RPLs to be 
generated. The RAPOOL operand of the DFHTCT TYPE=INITIAL macro 
instruction is used to specify the fixed number of RPLs that are 
generated in the TCT prefix. 

CICS/VS issues a receive-any for each RPL not currently in use, if 
fewer than the maximum allowable number of tasks are running and the 
short—on—storage condition is not present. (The sum of receive—anys 
outstanding plus the number of active tasks never exceeds the maximum- 
task value.) When the number of active tasks reaches this level (as 
specified in the DFHSIT TYPE=CSECT macro instruction), no new tasks can 
be initiated by DFHZCP, so no receive—anys are issued until the 
condition is relieved. 

The number of RPLs required is dependent on the expected activity of 
the system, the average transaction lifetime, and the maximum—task value 
specified. To aid the system programmer in choosing a size for the RPL 
pool, CICS/VS keeps a count of the maximum number of RPLs in use at any 
one time, plus how many times this maximum was reached. (See 
"Statistics 11 later in this chapter.) 

Associated with each receive—any RPL is an I/O area, the size of 
which is specified by the RAMAX operand of the DFHTCT TYPE-INITIAL macro 
instruction. If the input length exceeds the size of this I/O area, 

| ACF/VTAM gives CICS/VS only as much of the data as fits into the CICS/VS 
I/O area, and tells CICS/VS how much was received in total. CICS/VS 
then handles the data in one of two ways: 

• If the data length is less than RAMAX multiplied by RATIMES (also 
specified by the system programmer in the DFHTCT TYPE=INITIAL macro 
instruction), CICS/VS obtains an area large enough to accommodate 
the data through its storage control program, and then receives the 

| rest of the input data kept by ACF/VTAM (because all of it did not 

fit into the CICS/VS I/O area). 

• If the data length exceeds the RAMAX times RATIMES value, an 
exception response, indicating data over—length, is sent by the 
node abnormal condition program (DFHZNAC) to the terminal. This is 
not true, however, for 3270s or when the chain assembly feature is 

| being used. Any data length (up to the ACF/VTAM buffer limits) is 

valid from 3270s when chain assembly is being used. 

The RAMAX and RATIMES operands apply to all TCTTEs (except 3270s and 
logical units using chain assembly). The optional TIOAL operand of the 
DFHTCT TYPE=T ERMINAI macro instruction is provided so that the system 
programmer may specify the minimum size of a TIOA for a particular 
TCTTE. If specified, this is the minimum size TIOA that the CICS/VS 
application program expects to receive. If TIOAL is not specified, 
there are no minimum size requirements, and the input data is sent in a 
TIOA, of length egual to that of the data, to the CICS/VS application 
program. Therefore, if TIOAL is greater than RAMAX, the length 
specified in TIOAL is passed to the application program regardless of 
the actual length of the input data. 

The system programmer can also specify a minimum size for the 
receive-any I/O area through tne RAMIN operand of the DFHTCT 
TYPE-INITIAL macro instruction. RAMIN is the size below which any input 
is transferred from the receive—any I/O area to a new TIOA. The length 
of this new area depends on whicn logical unit sent the data, and its 
size is the greater of the data length itself or TIOAL. This allows the 
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CICS/VS application program to receive an I/O area length at least as 
large as it expects. 

To obtain data in response to a read reguested by a CICS/VS 
| application program, DFHZCP issues a ACF/VTAM RECEIVE macro instruction 
with the OPTCD=SPEC operand to allow data from a specific logical unit 
to be received. The data is received directly into the user TIOA; no 
separate receive-specific I/O area is provided. 

Each input message is called a chain. If its length exceeds the 
maximum output buffer size for the terminal (RUSIZE in DFHTCT 
TYPE=TERMIHAL), the message will be broken up into a series of links (or 
| request units) not exceeding this buffer size. The ACF/VTAM RECEIVE 
macro obtains only a single request unit at a time. The system 
programmer may control whether a CICS/VS application program input 
request is to be satisfied by a single request unit or by the assembled 
chain of request units. This control is provided by the CHNASSY operand 
of the DFHTCT TYPE^TERMINAL macro. 


OUTPUT SERVICES 


Output services handle both data to the logical units and asynchronous 
| output such as ACF/VTAM indicators and commands. This section describes 
| CICS/VS support of data output in general; ACF/VTAM indicators, as they 
relate to the system programmer, are described in "Basic Concepts" 
earlier in this chapter. 

When generating support for the available output services, the system 
programmer has the following main areas of responsibility: 

• Determining the maximum data length that each logical unit can 
receive. This value is specified by the BUFFER operand of the 
DFHTCT TYPE=TERMINAL macro instruction, except for 3270 logical 
units, which use segmenting with the BUFFER size set to zero. If a 
message longer than this value is to be sent, it is broken into as 
many links (request units) as necessary. Each link has a maximum 
size equal to the BUFFER value; the first link may contain the SNA 
function management header (FMH), but the total length of this 
first link (including the FMH) does not exceed the value of BUFFER. 
The default value is zero, which specifies that the data should not 
be chained but should be sent just as it is presented to DFHZCP by 
the CICS/VS application program. 

The value specified in the BUFFER operand must not exceed the 
logical—unit buffer size minus the buffer prefix size, as specified 
| to ACF/NCP/VS• (For information on specifying the buffer prefix 

size see the IBM 3704 and 3705 Communications Controller Network 
Control Procrram/VS Generation and Utilities Guide and Reference 
I Manual (for OS/VS and VSE ACF/VTAM Users .) 

• Specifying the response level (either FME/DR1 or RRN/DR2) to be 
used by CICS/VS when transmitting user data. This is specified in 
the RESP operand of the DFHTCT TYPE=INITIAL macro instruction and 
applies to 3600 logical units; this level is used for both normal 

| and exception response requests. The default value is FME* All 

| other logical units use DR1 only, except LU6 which interprets DR2 

| as a sync point request. The responses FME and RRN are also known 

as DR1 and DR2, respectively. 
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MESSAGE RECOVERY AND EMERGENCY RESTART 


Two distinct environments exist which require message recovery: 

• Catastrophic failures 

• Noncatastrophic failures 

A catastrophic failure is one in which either CICS/VS abnormally 
terminates, or some other failure (such as power loss or machine check) 
causes host processing to be abnormally terminated. 

A noncatastrophic failure is one in which a particular connection is 
interrupted because of some malfunction in the network. Both CICS/VS 
and the logical unit remain operational, but cannot communicate with 
each other because of the failure. In this case, the CICS/VS node 
abnormal condition program (DFHZNAC) is invoked to terminate the task. 

The primary objective of the message recovery procedure is to 
ascertain whether or not a message that was in-flight when a failure 
occurred was delivered to its destination. 

Following a catastrophic system failure, several CICS/VS facilities 
and techniques are used for message recovery: 

• The protected task and the deferred write, which govern the logging 
and response activities during normal transaction processing. 

• The system log, which enables CICS/VS to reconstruct the 
environment for any connection (represented by a TCPTE) that had a 
terminal message in-flight at the time of a failure. 

• The temporary storage message cache, which contains information 
related to the failing task. 

These facilities and techniques are discussed in the following 
paragraphs. Refer to the CICS/VS System/Application Design Guide for 
further information about recovery, restart, and emergency restart. 


CATASTROPHIC FAILURES 


During a catastrophic failure, CICS/VS does not have an opportunity to 
record any information concerning messages that are in—flight at the 
time of the failure. Therefore, selected parts of the message traffic 
(outbound messages preceding a synchronization point or the detachment 
of the task and the initial input for a task and any input that follows 
a synchronization point) must be recorded on the CICS/VS system log 
during normal operation so that message recovery during emergency 
restart can be performed. Information concerning a message is recorded 
on the system log only for messages associated with a task that is 
protected. 

Before describing the recovery techniques employed by CICS/VS, the 
protected task concept must be explained. This concept is relevant to 
the system programmers decisions concerning the message option group 
which he must specify if he wants to achieve a controlled and 
predictable situation for the message traffic. The message option group 
(described below) is a program control table (PCT) function that permits 
the specification of the CICS/VS support necessary for message 
protection. 
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Protected- Tastes 


If a system failure occurs and CICS/VS emergency restart is necessary, 
message recovery is possible only if the task in-flight at the time of 
the failure was protected. CICS/VS keeps a system log of messages 
preceding a synchronization point or task detach only for tasks which 
are declared as protected. During recovery, output messages are not 
retransmitted for certain logical units even if the DF9SG PROGRAM=RSP 
macro instruction includes RESEND=YES, because certain logical units do 
not support the set and test sequence number (STSN) command. The user 
can retransmit messages using information in the temporary storage 
message cache (DFHM ,l termid H ) • 

The process of logging information for protection against a 
catastrophic system failure imposes an additional overhead on tasks 
running under CICS/VS. Therefore, the system programmer is allowed to 
specify which transactions are protected and which are not. Recovery of 
messages after a catastrophic failure requires CICS/VS journaling and 
the system log. 

Nonprotected tasks should include those which only inquire about a 
data base or any other task for which double processing of the task 
following reentry of the task after a system failure would have no 
detrimental effect even if it occurred. 

The possibility of double processing arises because a task may 
complete prior to the failure, but be unable to issue a completion 
message to the logical unit. If a task performs only an inquiry of some 
data base record, reentering the request to recreate the reply after a 
system failure does not lead to invalid results. If, however, a task 
performs some update to a data base record, and the operator does not 
know whether processing was complete at the time of failure, reentering 
the original request may cause a double update of the data base record, 
thus leading to erroneous results. This would not happen if the task 
were declared as protected. 


Message Option Groups 


To control the message protection processing for a task executing on a 
| ACF/VTAM—supported TCTTE, the system programmer may generate message 
option groups, which specify the manner in which CICS/VS DFHZCP is to 
treat the logical unit I/O requests for protection and recovery 
purposes. 

The message option group definitions should immediately follow the 
DFHPCT TYPS=INITIAL macro instruction. The OPTGRP operand of this macro 
instruction must be specified in order to make the options available for 
the task. The message option group name specified by the OPTGRP operand 
determines which option group is to be used for the task whose PCT entry 
references this group; this name also must appear as a symbol prefixed 
to the DFHPCT TYPE=OPTGRP macro instruction, whose parameters specify 
the desired characteristics (see below). 

The system programmer specifies any of the available parameters as 
either reguired or optional. The MSGPREQ operand defines the processing 
options and characteristics that are required for the task. All of the 
parameters specified with this operand must be supported by the TCTTE on 
which the task executes; otherwise, the task initiation request is 
rejected. Alternatively, the MSGPOPT operand defines the processing 
options which the task uses only if the TCTTE on which it is running 
supports the function. If the function is not supported by the TCTTE, 


Chapter 5.2. ACF/VTAM Logical Onits with CICS/VS 


4 93 



the task initiation request is not rejected, because the functions are 
optional by definition- There is no default value for either the 
MSGPREQ operand or the MSGPOPT operand; if omitted, no options are 
generated for the task. 

The following message group options can be specified with either the 
MSGPREQ operand or the MSGPOPT operand. See below for a discussion on 
the relationship between MSGPREQ and MSGPOPT. 

• PROTECT specifies that the task is protected, and implies the 
MSGINTEG parameter. CICS/VS also logs messages for protected 
tasks. PROTECT causes any write operation to a logical unit 
performed by a transaction to be deferred either until the CICS/VS 
application program issues a terminal wait request or until the 
task goes through a sync point or detaches. It ensures that the 
last message from a transaction (which confirms to the terminal 
operator that processing completed) is not delivered until the task 
has passed the commit point and is immune from backout if a system 
failure occurs. 

• MSGINTEG specifies that any output sent by CICS/VS to a logical 
unit on behalf of a task is sent with definite response protocol 
specif ied. 

• ONEWTE specifies that the transaction can perform one write only 
during its execution. DFHZCP sets an end bracket (EB) indicator on 
the first write processed for the task. Any subsequent write from 
the task is treated as an error by DFHZCP (because it would violate 
the bracket protocol), and the task is abnormally terminated. This 
parameter shortens the response time for simple, one—write 
transactions which run on TCTTEs that support the bracket protocol. 

Any of the above parameters can be specified singly or with other 
parameters. 

The CCONTR operand specifies that the application program may control 
the outbound chaining of request units. If this option is specified, 
the MSGPREQ/MSGPOPT option PROTECT must not be specified. If CCONTR=YES 
is specified, ONEWTE means one chain (a chain is defined as the smallest 
recoverable unit), and not one DFHTC TYP£=WRITE. 

The user can specify optional and required task options when 
generating the program control table (PCT). At attach time, those 
options that are specified as optional execute if the logical unit 
permits them; however, if the logical unit does not permit an optional 
function, the task is attached, but that option is not performed. Those 
options that are specified as required execute if the logical unit 
permits them; however, if the logical unit does not permit a required 
function, the task is not attached. 


Emergency Restart and Message Logging 


Normally, the first entry on the log for a given protected task consists 
of a start-of—task indicator, the data sent by the originator of the 
task, and the inbound and outbound sequence numbers. If any change has 
been made to a protected resource (a data base record, for example), the 
original copy is also logged. 

Once the task—originating data and start—of—task indicator have been 
logged, the task is considered in—flight. Any tasks in—flight at the 
time of failure are backed out by CICS/VS during emergency restart. The 
act of backing out means that all effects of the task are removed from 
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the system, based oh the recordswritten to the system log. Naturally, 
messages already received or transmitted cannot be backed oat, but 
operations such as updates on protected system resources which occurred 
during the course of the transaction can be backed out. 

The end of a protected task causes the CICS/VS to write the response 
message, the most recent inbound and outbound sequence numbers, and the 
end-of—task indicator to the system log. As soon as the end—of—task 
indicator has been logged, the task is no longer considered in-flight? 
it is now considered committed and is immune from backout. 

At this point, the deferred write becomes important. If the reply to 
the input message had been sent as soon as it was requested (that is, 
before the information was logged), a period of uncertainty would exist 
during which the task could still be backed out, because, as mentioned 
previously, a task is not immune from backout until the end of the task 
| has been logged. Because ACF/VTAM and the ACF/tfCP/VS are able to 
operate asynchronously from CICS/VS, the message could conceivably be 
delivered while CICS/VS is abnormally terminating. In this case, the 
task is backed out when emergency restart is performed, yet the terminal 
operator has already received a message confirming that the task 
completed. Because backing out the task removes the effects of the task 
from the system, the message sent to the terminal would be inconsistent 
with the status of the data bases. 

To guard against the above situation, the deferred write is employed. 
This ensures that any message created by a transaction that does not 
| specify a wait is not physically transmitted to ACF/VTAM either until a 
terminal control wait is explicitly specified or until the task goes 
through sync point processing, thereby ensuring that all messages sent 
to the terminal are consistent with the status of the data bases. 


Em ergency Restart 


During an emergency restart of CICS/VS, the information presented to 
CICS/VS concerning the system activity at the time of the failure 
comprises the records that appear on the system log. 

Any failure that occurs prior to the logging procedure is not 
detected, and CICS/VS assumes that the task-originating data was never 
received. This is the same as if the failure had occurred while the 
task—originating data was being sent from the logical unit to CICS/VS 
and was lost in the network because of the failure. 

Prom the data recorded on the system log, CICS/VS reconstructs the 
environment for any TCTTE that had either committed output pending or a 
message in—flight for a protected task at the time of failure. (The 
system log contains information about the terminal messages of protected 
tasks.) The environment reconstruction includes placing transaction- 
related information into the temporary storage message cache* 

The message cache is an area in temporary storage with the name 
DFHftxxxx, where xxxx is the four—character logical—unit identification. 
For a task failing in—flight, the message cache contains the data from 
the task—originating message, plus the transaction code, task number, 
and message sequence number. A flag byte indicates whether the data is 
for an inbound or an outbound message and if logged with or without an 
FMH. If the failure occurred after the task had passed the commit 
point, the message cache contains the output message rather than the 
input message. If neither of these two conditions is present, the 
message cache is not created by emergency restart. 
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The system programmer may wish to write an application program to 
investigate the contents of the message cache following a system 
failure; if so, he should understand the format of the contents of the 
message cache. A discussion of the message cache can be found in the 
CICS/VS System/Application Design Guide . 


NONCATASTROPHIC FAILURES 


Environment reconstruction is not necessary following a noncatastrophic 
failure, because CICS/VS and the logical unit remain operational; 
message recovery is performed immediately after the failure is rectified 
by the node abnormal condition program (DFHZNAC) and, optionally, by the 
installation^ node error program (NEP) . Thus, DFHZNAC does not use the 
CICS/VS system log. 

The protected task and message integrity concepts are important 
because DFHZNAC uses the task*s TIOA (which contains the data) in its 
recovery procedures. When errors are detected for tasks with message 
integrity, the TIOA is guaranteed to be available; for tasks without 
message integrity, the TIOA may have been released before the error was 
reported for processing. The actions taken by DFHZNAC for failing 
messages depends on the nature of the error and its circumstances; 
however, reliable information about a failing task is guaranteed only if 
the task has message integrity. 


Logical Unit I/O Error Handling (DFHZNAC/DFHZNE P) 


The node abnormal condition program (DFHZNAC) is a system program 
responsible for processing all abnormal situations associated with a 
logical unit. This is analagous to the situation under BTAM support in 
which terminal abnormal condition program (DFHTACP) is scheduled to 
resolve terminal errors. However, there is a difference between the 
| DFHTACP/DFHTEP interface under BTAM and the functions of the ACF/VTAM 
eguivalents, DFHZNAC and DFHZNEP. 

The implementation of terminal error processing for BTAH—supported 
terminals is such that any error is normally routed to the terminal 
abnormal condition program (DFHTACP). Depending on the type of error, 
DFHTACP issues messages, sets error flags, etc., and hands over control 
to the user-written terminal error program, DFHTEP, a dummy version of 
which is supplied by CICS/VS. After any necessary action by DFHTEP, 
control is handed oack to DFHTACP via a DFHPC RETURN request. The 
interface between the node abnormal condition program pFHZNAC) and node 
error program (DFHZNEP) is basically the same as that between DFHTACP 
and DFHTEP. The system programmer has the capability of providing, in 
table form, an interface module and a separate error routine for each 
specified transaction class. The function of the interface module, 
DFHZNEP, is to allow a particular transaction to have its own error 
processing procedure and determine which class of transaction is 
attached to the terminal and to link from DFHZNAC to the appropriate 
transaction-class error routine, identified via a macro used in 
assembling DFHZNEP. On completion of the action in the transaction- 
class error routine, control will be returned to DFHZNAC via DFHZNEP 
using the normal DFHPC RETURN request. 

| Note that for BTAM support, a new TACP task is created for each TACLE 
| to be processed, whereas, for ACF/VTAM support, only one ZNAC task is 
| created, which processes many TCTTEs. 
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The transacti on class is identified to DFHZNEP via the NEPCLASS 
operand of the DFHPCT TYPE=ENTRY macro. The identifier is placed in the 
program control table for reference by the DFHZNEPI TYPE=ENTRY macro 
which associates the transaction class with a named user—written 
transaction—class error routine 4 For full details on the generation ana 
function of DFHZNEP, refer to the section in Chapter 4.3 on ••User- 
written Node Error Programs”. 

For logical units, ail information concerning the processing state of 
the terminal is contained in the TCTTE and RPL. No accompanying line 
entry exists for a logical unit as is the case for a BTAM-supported 
terminals. Consequently, when a terminal error must be handled for a 
logical unit, the TCTTE itself is placed onto the system error queue. 

The action flags, set by DFHZNAC to assist the transaction—class 
error routines, are in TWAOPTL, which is in DFHZNAC*s transaction work 
area (TWA). 

The transaction-class error routine can interrogate TWAOPTL and 
modify the bit settings, if the user wants to modify DFHZNAC 1 s 
subsequent actions regarding the abnormal situation. If the user agrees 
with DFHZNAC* s proposed actions, TWAOPTL is left unaltered. 

In most cases, the transaction—class error routine can modify 
DFHZNAC*s proposed actions. The only time that DFHZNAC overrides the 
routine*s modification of TWAOPTL is when a logical unit is to oe 
disconnected from CICS/VS; that is, when DFHZNAC determines that the 
| abnormal situation requires that CICS/VS issues the ACF/VTAM CLSDST 
macro instruction for a logical unit. In such a case, the eventual 
action will depend on the two—byte system sense code received. If the 
system sense code is zero, the action specified by the transaction—class 
error routine will prevail. If the system sense code is other than 
zero, however, DFHZNAC will disconnect the terminal and abnormally 
terminate the task even if the transaction-class error routine tries to 
block such actions. 

Resetting of the task termination flag by the node error program is 
also ignored if a negative response has been sent to a logical unit or 
if DFHZEMW is to write an error message to the logical unit. 

When control is returned to DFHZNAC from DFHZNEP, DFHZNAC performs 
the actions specified in TWAOPTL (except when disconnecting logical 
units, as noted above), issuing messages and setting error codes, as 
necessary. 

DFHZNAC assumes that system sense codes are available upon receipt of 
an exception response from the logical unit. Thus, analysis is 
performed to determine the reason for the response. Decisions, such as 
which action flags to set and which requests are needed, are made based 
upon the system sense codes received. If sense information is not 
available, default action flags are set, and DFHZEMW is scheduled to 
send a negative response, if a response is outstanding, with an error 
message to the terminal. 

Appendix E lists the actions taken by DFHZNAC upon receipt of inbound 
system sense codes. 

Prior to executing the specified mandatory executive routines, 

DFHZNAC links to the user—written transaction-class error routine, via 
the interface module, DFHZNEP, in which action can be undertaken based 
upon user—defined criteria. 

The system programmer^needs to code a transaction—class error routine 
only if he wishes to perform additional error processing beyond that 
performed by DFHZNAC. DFHZNAC gives control to the interface module. 
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DFHZNEP, and thus to the transaction—class error routine by issuing a 
DFBPC LINK request. DFHZNAC also passes the address of the TCTTE 
concerned, so that the system programmer can specify further recovery 
actions based on the processing state of the logical unit, When the 
transaction-class error routine has performed its functions, control is 
returned to DFHZNAC via DFBZNEP by issuing a DFHPC RETURN request. 

Upon entry to DFHZNEP and the transaction—class error routine, the 
following fields are available to the system programmer: 

• The error code generated by DFHZNAC. The error codes are indicated 
in the discussion on the node error program and in Appendix E. The 
error code is located at TWAEC• 

• The action flags set by DFHZNAC. These flags are depicted in 
Figure 5*2—1 and are defined in the section on the node error 
program and in Appendix E. The collective field name for these 
flags is TWAOPTL. 

• The address (TWATCTA) of the TCTTE. 

• The terminal name, at TWANID. 

• The sense codes received by DFHZNAC: 

— TWASR1 and TWASR2, system sense codes. 

— TWAUR1 and TWAUR2, user sense codes. 


Linkage to DFHZNEP is provided by CICS/VS. Fields in the TWA are 
defined in the copy section DFHVTWA, which provides a DSECT of the node 
abnormal condition program's TWA. 


Byte 


Action Code Options 


TWA0PT1 


TWA0PT2 


A ction—code Description 

Label 


TWAOAF 

Print action flags 

(X' 80 *) 

TWAORPL 

Print RPL 

(X • 4 0 •) 

TWAOTCTE 

Print TCTTE 

(X*20» ) 

TWAOTIOA 

Print TIOA 

(X* 10») 

TWAOBIND 

Print bind area 

(X*08 •) 

TWAOAS 

Abort VTAM SEND 

(X'80') 

TWAOAR 

Abort VTAM RECEIVE 

(X * 40*) 

TWAOAT 

ABEND task 

(X*20*) 

TWAOASM 

SIMLOGON required 

(X*02') 

TWAOGMM 

Good morning 



message required 

(X * 08 •) 


Figure 5.2—1 (Part 1 of 2). 
Options 


DFHZNAC Action—Code Bytes and Available 
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Byte 


Action Code Option 


Action-code Description 

Label 


TWA0PT3 


TWAOINT 

TWAONINT 

TWAONCN 

TWAOSCN 

TWAONEGR 

TWAOOS 

TWAOCN 


TWAOPT4 


1 TWANOMG1 
' TWANOMG2 
■ TWANOMG 3 
| TWANOMG4 
TWANOMG5 


INTLOG can be set 

No internal LOGONS 

(X • 80 ') 

can be generated 

Close session (no 

(X*40*) 

user reset) 

Close session (user 

(X'10«) 

reset allowed) 

(X* 08* ) 

Negative response 

Keep node out of 

(X'04») 

service 

Cancel session 

(X*02 *) 

(abnormally) 

(X*01») 

No level one message 

(X»01») 

No sense code message 

(X*02 *) 

No message three 

(X • 04 •) 

No security message 

(X*08') 

No action message 

(XMO*) 


Figure 5.2—1 (Part 2 of 2). DFHZNAC Action-Code Bytes and Available 
Options 


Explanation of the flags follows: 

The first five labels (TWAOAF, TWAORPL, TWAOTCTE, TWAOTIOA, and 
TWAOBIND) are principally debugging aids for the user. NACP writes the 
desired information to the CSMT log if its accompanying bit is set. 

The next five (TWAOAS, TW AOAR, TWAOAT, TWAOASM, and TWAOGMM) are task 
related. If the task is to be abnormally terminated, sends and receives 
are purged. If TWAOGMM is set, CICS/VS will automatically schedule the 
good morning message (transaction CSGM) . This will be of use where the 
contents of the screen have seen lost or when the failing session can be 
restarted. 

Note: If the reguest is to be retried and if the break connection 

action flag is not on (that is, if TWAOCN is off), TWAOAS, and/or 
TWAOAR, and/or TWAONEGR must be off as well as TWAOAT. 

The flags in byte TWA0PT3 are node related. If TWAOCN is set, the task 
is abnormally terminated and communication with the node is lost. 

Setting TWAOOS indicates no further processing is to be done for this 
node. The node is logically out of service. 

Setting TWAOSCN provides the same function as TWAONCN but can be reset 
by the user if the session is not to be closed. 

The flags in byte TWA0PT4 are message related. They can be set by the 
user to prevent the messages indicated being issued - 

If DFHZNAC is scheduled because of the receipt of an exception 
response, the sense information in the TCTTS is available to DFHZNAC and 
DFHZNEP to determine any necessary actions. 

If DFHZNAC is scheduled because of loss of the connection between 
CICS/VS and a logical unit, DFHZNAC abnormally terminates any 
transaction in progress at the time of the failure. DFHZNEP and 
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transaction—class error routine analysis and processing are permitted, 
but message retry should not be attempted. 

The DFHZNAC error message is sent to the master—terminal log after 
| linking to DFHZNEP so that the user may control the printing of 
| messages. User—written messages may also oe sent to the log using the 
transient data facility. To write the installation^ own messages, the 
system programmer must code the DFHTD TYPE=PtJT macro instruction 
directly into the transaction—class error routine. 

The CICS/VS terminal control macro enables the system programmer to 
| issue ACF/VTAM indicators in the transaction-class error routine. The 
available functions are explained in ,f Modifying the TCT•* in Chapter 6.5 
of this manual. 


DFH ZNAC Logging Fa ci lity 


To aid in retrieving related information (that is TIOA, CSA, TCA) about 
a problem in a real time environment, a logging facility is available in 
DFHZNAC. 

For example, if during the processing day a logical unit sends an 
exception response to data sent from the host, the TIOA can be examined 
to locate the problem. 

DFHZNEP can pass the address of the TIOA plus a desired length (not 
exceeding 220 bytes) in DFHZNAC 1 s TWA. On return to DFHZNAC, the data 
is logged to the CSMT or CSTL transient data log for future inspection. 

TWA fields are: 


Name Lengt h Conten t 

TWANLD 4 bytes address of data to be logged 

TWANDLDL 2 nytes desired length of data to be logged 

N ote : All data in excess of 220 bytes is not logged. 


CICS/VS,TERMINAL CONTROL 


The terminal control macro instruction provides capabilities intended 
only for CICS/VS management modules and for the system programmer. The 
system programmer may use these macro instructions to: 

• Scan the terminal control table (CTYPE=L0CAT2) 

• Change the status of a logical unit (CTYPE=STATUS) 

| • Issue a ACF/VTAM indicator (CTYPE=C0MMAND) 

• Check the outcome of any of the above operations (CTYPE=CHECK) 

For details of these facilities, refer to "Modifying the Terminal 
Control Table 11 in Chapter 6.5 of this manual. 
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transaction options 


When specifying the PCT entries for transactions (through the DFHPCT 
TYPE=ENTRY macro instruction), the system programmer may: 

• Restrict certain transactions to run only for logical units or for 
BTAM—supported terminals. 

• Specify transaction options related to message journaling. 

• Specify I/O processing options. 

• Control message protection options. 

The DVSUPRT operand specifies that certain transactions are permitted 
| to execute only for a terminal or for a logical unit. The ACF/VTAM 
parameter of this operand restricts the transaction to being executable 
| only on a ACF/VTAM TCTTE• The NONV parameter restricts the transaction 
| to being executable only on a non—ACF/VTAM TCTTE (for example, a BTAM, 

BSAM, or a GAM TCTTE)• The ALL parameter specifies that the transaction 
may execute on any TCTTE; ALL is the default value for this operand. 

The MSGJRNL operand specifies whether or not automatic journaling of 
messages is to be performed by the terminal control program for 
particular transactions. Message journaling may be requested for either 
input or output messages, or both. 

If the MSGJRNL operand is specified, the JFILEID operand must also be 
specified in order to indicate where the automatic journaling 
information is to be recorded. The SYSTEM option indicates that the 
information for messages associated with logical units is to be recorded 
on the system log. To record the information on a particular 
installation journal data set instead of on the system log, the journal 
identification must be specified; this identification can be any value 
in the range 2 through 99, inclusive. If NO is specified, message 
journaling is not performed; NO is the default value for this operand. 

If the automatic journaling option is selected, the system programmer 
must ensure that the relevant journal control program and journal 
control table parameters are specified to support the DFHTCP automatic 
journaling requests. 

The I/O processing options (DELAY and IMMED) are discussed in "Output 
Services" earlier in this chapter. 

The message option groups specify the manner in which CICS/VS DFHZCP 
is to treat the logical unit I/O messages for protection and recovery 
purposes; they are discussed earlier in this chapter. 


A UTOMATIC TASK INITIATION f ATI) 


Before CICS/VS attempts automatic task initiation (ATI) for a logical 
unit, it checks whether ATI is allowed for the particular logical unit. 
To permit ATI, the TCTTE that represents the logical unit must be in 
exther the TRANSCEIVE or RECEIVE state, and must also be in service. 
These states are specified in the TRMSTAT operand in DFHTCT 
TYPE=TERMINAL. 

A TCTTE may be in service or out of service independent of whether or 
not it is connected to CICS/VS. If a logical unit TCTTE is in service 
| but not connected when ATI is to be performed, and TRMSTAT=INTLOG is 
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| specified, then CICS/VS requests a ACF/VTAM simulated logon to establish 
| connection. If TR M STAT= NOINT LOG is specified, then the ATI request is 
| ignored until the connection is established by the otner node, or the 
| status is changed. 

The system programmer must ensure that the TCTTE for which ATI is 
requested is either in transceive or receive state, and is in service. 
These parameters may be specified when the terminal control table is 
generated (through the DFHTCT macro instruction) . They may also be 
specified by the DFHTC CTYPE=STATUS macro instruction of the terminal 
control interface to enable dynamic status changes. Refer to Chapter 
6.5 for further details of the DFHTC CTYPE=STAT0S macro. 


I USER EXIT ROUTINES FOR CICS/VS ACF/VTAM TERMINAL CONTROL 


| CICS/VS ACF/VTAM logical unit support provides the system programmer 
with the option of coding user exit routines, which are to be given 
control at defined points during the processing of a request by CICS/VS 
| ACF/VTAM terminal control. 

| The two methods available for using user exits are described in 
| Chapter 6.2. 

| The following information is based on the new user exit interface. 

Because the exit routines are executed as an extension of a CICS/VS 
management module, the designer of the exit routine must be fully aware 
of the conventions and restrictions that apply in such an environment. 
The exit routine must be coded in assembler language and be at least 
serially reusable. Requests for CICS/VS services are forbidden in the 
exit routine. Issuing a wait within a management module, which is 
servicing a request that is executing under a non-user TCA, can 
seriously degrade system performance, and unexpected task switches from 
within management modules may lead to unpredictable system damage. 

Control is given to the specified exit routine at each of the 
| following three points every time a request referring to a ACF/VTAM— 
supported TCTTE is serviced: 


I Exit Proc essin g Sta te 

| XZCATT Prior to a task attach* 

| XZCOUT Prior to issuing the logical message in the DFHZCP send 

subroutine; no chaining requirements have yet been 
determined. 


| XZCIN After the entire logical message is received by CICS/VS. 

| At each exit, register 8 points to the TIOA and register 10 points to 
| the TCTTE being processed. 


| For XZCATT, register 8 points to the TIOA containing the transaction- 
originating data. 

| For XZCIN, if the message is too large to fit into the CICS/VS I/O 
| area, CICS/VS will issue an additional receive-specific to obtain the 
| remainder of the message from ACF/VTAM, (see "Input Services" earlier in 
this chapter for further information), but control is given to the user 
exit routine only after the complete message has been received by 
| CICS/VS from ACF/VTAM. 
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| Old User Exit Facility 

I 


| The following information applies only to the user exit facility that 
| existed prior to CICS/VS release 1.5. 

| To include a user exit routine in CICS/VS ACF/VTAM terminal control, 
the required code and associated label must be placed into the CICS/VS 
source library member (book), DFHTZEXT, prior to generating and 
| assembling the CICS/VS DFHZCP module (for exit ZATTACB) or the DFHZCB 
| module (for exits ZINPUT and ZOUTPUT). Only one exit routine is 
| supported for each exit for each CICS/VS ACF/VTAM terminal control 
j module; if more than one CICS/VS ACF/VTAM terminal control module is 
generated, the system programmer is permitted to code a different exit 
routine (with a distinguishing label) for each. The code for each 
routine must appear in DFHTZEXT, preceded by its reference label. 

| When generating a DFHZCP or DFHZCB module, the required exit is 

indicated by specifying its label as the parameter of the exit operands 
| (ZATTACH, ZINPUT, and ZOUTPUT) of the DFHSG PBOGRAM^TCP macro 
instruction. 

I N ote ; The ACF/VTAM terminal control program consists of six modules. 
Only DFHZCP and DFHZCB contain user—exit code. 

| CICS/VS DFSZCP generates linkage to the appropriate exit routine by 
the sequence: 

L 14, =V (label) 

BALR 14,14 

| If no exit operands are specified, CICS/VS does not generate any of 
| the linkages, and the DFHTZEXT code is not included in the ACF/VTAM 
terminal control program. 


BMS SERVICES 


Mapping support for logical units is generated by specifying the 
reguired parameter of the BMSDEV operand in the DFHSG PROGRAM=BMS macro 
instruction. If these parameters are not specified, BMS routines for 
the relevant logical units are not included. The batch data interchange 
program (DFHSG PROGRAM=DIP) must be generated if BMS routines are 
required for batch logical units. 

The BMSDEV operand is used to specify all non—3270 devices for which 
BMS support is to be generated. If the operand is not specified, 
support for all devices is assumed by default. The generation of the 
routines which support 3270 mapping is controlled through the existing 
MAP3270 operand. 

When generating BMS functions into the system, the system programmer 
is provided with considerable flexibility for tailoring the amount of 
support included. By choosing only those functions required for a 
particular installation, the working set requirements for a system can 
be significantly reduced. 

The ROUTING operand of the DFHSG PROGRAM=BMS is available to provide 
routing facilities for certain logical units. The CICS/VS temporary 
storage management module (DFHTSP) is required to support the routing 
function. The system programmer must generate the DFHSG PROGBAM-TSP 
macro instruction if the routing facility is specified. 
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gapping Individual Recor d s and Entire Chain s 


In order to map each card or line of a request unit (R0) separately,- the 
user should specify logical record presentation for the transaction (in 
the LOGREC operand of DFHPCT TYPE=ENTRY) for logical units for which 
logical record presentation and chain assembly apply. Otherwise, all 
records after the first in the RU will be bypassed. 

In order to map an entire chain, potentially consisting of more than 
one RU, the user should specify the CHNASSY operand in the DFHTCT 
TYPE=TERMINAL macro for the logical unit. 


STATISTIC S 


Existing statistics are maintained for each logical unit. The following 
statistics are incremented by one whenever the indicated condition 
occurs: 

Statistic Condition 


| Write count ACF/VTAM SEND is accepted by a logical unit on behalf of a 
terminal for part of a chained output data message. 


| Read count 

I 

| Error count 


ACF/VTAM RECEIVE is completed for an input data request sent 
by a logical unit on behalf of a terminal. If more than 
one RECEIVE was necessary for CICS/VS to obtain the 
complete request unit from ACF/VTAM, the read count is still 
only incremented by one. 

ACF/VTAM SEND is rejected by a logical unit on behalf of a 
terminal for any part of an output data message. 


Error count An exception response is received by CICS/VS for any 
reason. 


Statistics are kept for evaluating the size of the receive—any RPL 
pool. (See "Input Services" earlier in this chapter for information 
about the RPL pool.) Every time DFHZCP is dispatched, it scans the pool 
of RPLs and counts the number of RPLs that were posted complete. DFHZCP 
records the maximum value of this count and increments a second counter 
each time this maximum is reached; every time a new maximum is recorded, 
the second counter is reset to one. This statistic is printed along 
with any reguest that produces the existing terminal statistics; it 
gives the maximum value achieved and the number of times it was reached. 

In a system in which the maximum value is less than the size of the 
RPL pool during the course of a normal day, the number of RPLs specified 
for the pool could be reduced to the maximum value with no effect on 
system performance. Conversely, if the maximum value reaches the size 
of the RPL pool many times during the day, this may indicate a 
bottleneck in the system that might be causing unnecessary use of the 
| pageable buffer area by ACF/VTAM; this situation could be improved by 
increasing the RPL pool size. 

A good trial value for the size of the RPL pool is the maximum task 
value which is specified by the MXT operand of the DFHSIT TYPE=CSECT 
macro instruction. The value should then be reduced in accordance with 
the statistics recorded for peak activity. Too high a value may result 
in unnecessary page faulting within the RPL pool. 
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| Another statistic keeps a count of the number of times that ACF/VTAM 
temporarily rejects a CICS/VS request because a short—on—storage 
| condition exists in ACF/VTAM. This helps the user to monitor any system 
bottleneck that may arise because insufficient buffer space was 
| allocated during ACF/VTAM definition. 


MESSAGE SWITCHING 


When a terminal list table is built for use with message switching # each 
entry in the table contains logical unit identifications. The TRMIDNT 
operand of the DFHTLT TYPE=EMTRY macro instruction is used to specify 
the identification of the logical unit to be used to direct the message. 
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Chapter 5.3. The CICS/OS/VS TCAM Interface 


This chapter describes the use of TCAM under CICS/OS/VS. The following 
topics are discussed: 

• The use of TCAM in an SNA network, with reference to protocol 
management, FMH processing, and error processing. 

• The TCAM application program interface, including information on 
the process control block and the TPROCESS control block. 

• The interface between TCAM and CICS/OS/VS, which includes 
information on terminal entries (TCTTEs) and line entries (TCTLEs) 
data flow, logic flow, the terminal error program, message routing, 
pooling, and segment processing. 

• Device considerations, which deals with message formats for devices 
(in particular, the 2260 and 3270) being used on a TCAM line. 

• User exits, which gives information on the three TCAM exits which 
may be specified in the terminal control program. 

• The process of starting up, restarting after an abend, and 
terminating TCAM under CICS/OS/VS. 

• The TCAM message control program and its relationship to the 
application program (in this case, CICS/OS/VS). 

In addition, two sample TCAM message control programs for use in an 
SNA network can be found in Appendix F. 

The majority of independent teleprocessing applications require a 
dedicated network. The telecommunications access method (TCAM) permits 
multiple applications to share a single network, resulting in more 
efficient use of terminals and lines. The CICS/OS/VS/TCAM interface 
enables CICS/OS/VS to run as an application program under TCAM. 

TCAM is an access method that may be used alone or in combination 
| with other access methods (BTAM, BSAM, ACF/VTAM, and BGAM). 

One practical use of the CICS/OS/VS/TCAM Interface is to run a 
"production 11 CICS/OS/VS system in one region and a "test" CICS/OS/VS 
system in another. Running in separate regions, the applications are 
protected from one another. Operating under TCAM, terminals and lines 
can be shared by the two CICS/OS/VS applications. Other TCAM 
applications such as the time sharing option (TSO) can also be running 
concurrently. 

CICS/OS/VS user tasks that run under BTAM can, in general, run under 
TCAM without modification to the task code. This assumes that the user 
has properly designed and coded the TCAM message control program (MCP). 
However, in order to obtain tne benefits of TCAM SNA and to maintain an 
acceptable operator interface, it is usually necessary to change the 
CICS/VS application programs to use DFHTC CONVERSE and WRITE, LAST 
facilities so that the MCP is provided with sufficient information about 
the transaction to maintain the optimum SNA message flows. 

There are basic differences between TCAM and BTAM design methods. 
CICS/OS/VS was designed to operate in the BTAM environment. The 
CICS/OS/VS/TCAM Interface, although resolving most of the differences, 
must impose some restrictions when CICS/OS/VS is run in a TCAM 
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environment. These restrictions as well as some of the ramifications of 
selecting various user options are addressed in this section. Also 
described are the user facilities available and how the user implements 
and operates the system through the interface. 


C ICS/OS/VS WITH TCAM SNA 


| TCAM can be used to provide an SNA network without the use of ACF/VTAM. 
The CICS/OS/Vs/TCAM interface has an enhanced data stream support which 
enables a suitably written TCAM message control program (MCP) to control 
the SNA session. The TCAHFBT=SNA operand in DFHTCT TYPE=LINE allows 
TCTTEs to be specified for SNA devices* The user must be prepared to 
write an appropriate TCAM SNA message control program to complement the 
CICS/VS support and the SNA devices attached to the system. In order to 
obtain a good operator interface, the CICS/VS application programs 
should be designed to inform the MCP of their intentions. Thus, it is 
better to design the MCP and the application programs together. 

Sample TCAM SNA MCPs are provided in Appendix F. The second sample 
MCP (DFHSPTM2) uses the information passed in the CCB to optimize the 
message flows to the actual logical unit* This represents transaction- 
oriented processing. 

The support provided by TCAM for SNA devices running under CICS/VS is 
a data stream support* Both the SNA character string (SCS) and the 3270 
data streams are supported* 

In order to understand how CICS/VS works with TCAM in an SNA 
environment, it is important to understand the TCAM SNA structure. The 
device massage handler (DMH) is the logical unit in SNA terms. All data 
flow control (DFC), session startup and takedown, and response handling 
are provided in the DMH. There is no CICS/VS control of these SNA 
functions and the application programmer need not be concerned with 
these functions. For a more detailed discussion of the TCAM SNA 
functions provided, refer to the OS/VS TCAM System Programmers Guide . 


PROTOCOL MANAGEMENT 


Many different protocols may exist in an SNA network. The various 
protocols are established on a session basis by using the bind image. 

The decision on which protocols to use with which SNA session belongs to 
the system programmer, who should understand the requirements of the 
installations application programs before deciding on a specific 
protocol. 

Some of the more common of these SNA protocols are: bracket, half- 
duplex flip-flop (HDX—FF) , and half—duplex contention (HDX-CON) . The 
enforcement of these protocols is a function of the DMH. 

There are two ways of performing protocol management in a 
CICS/OS/VS/TCAM system: 

• Device message handler control 

• Transaction control 

These methods are discussed below. 
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Device Message, Headier Control 


This type of protocol management is used when the transaction wishes to 
be completely unaware of the device with which it is communicating. 
Although the communication control bytes are passed between CICS/VS and 
TCAM, they are not used to control the SNA session. All the protocol 
control is provided in the DMH. The appearance at the outboard LU is at 
the option of the system programmer (MH writer) instead of the 
application programmer* 


Transaction Control 


This method of protocol management is one in which the transaction 
exhibits control over the protocol. The SNA session should be bound 
with a protocol of HDX—FF with brackets when running this type of 
management. The second sample MCP provided in Appendix F is an example 
of a transaction controlled message handler (MH). 

When running with transaction control over the protocol, the 
communication control byte (CCB) is used to relay information from the 
transaction to the DMH• For example: 

• DFHTC TYPE=WRITE,LAST should be used to end a transaction. Issuing 
this macro causes an indicator to be set in the CCB requesting that 
the DMH send an end-of-bracket (EB)* 

• DFHTC TYPE=CONVERSE should be used when terminal input is required 
after a WRITE. This macro causes an indicator to be set in the CCB 
requesting that the DMH send the CHANGE DIRECTION indicator to the 
device. 

• DFHTC TYPE=DISCONNECT should be used to end the logical unit 
session. This macro causes an indicator to be set in the CCB 
requesting that the DMH terminate the LU—LU session (that is, issue 
the IEDHALT macro). 


FUNCTION MANAGEMENT HEADER (FMH) PROCESSING 


The FMH enables function management information to be directed to unique 
components within the logical unit. The FMH also provides a mechanism 
in which control information relating to the operation of those 
components may be passed. FMH processing is a bind time option (that 
is, a bind parameter is available to indicate whether an FMH may or may 
not appear in the LU to LU session). 

CICS/OS/VS/TCAM SNA provides support for the logical device code 
(LDC) which is transmitted in the FMH to the logical unit. The LDC 
provides for the communication of the logical disposition of output to 
the logical unit and can represent any meaning which is useful to the 
purpose of the installation. 

There are two ways that FMH handling can be provided. The first is 
for the transaction to provide the FMH as part of the data passed to 
TCAM by issuing a DFHTC TYPE=WRITE,FMH=YES macro. An indicator is set 
in the CCB so that the DMH can set the 11 FMH included" indicator in the 
request handler (RH) by using the IEDR3 macro. On input, the DMH should 
interrogate the RH (using the IEDRH macro) to determine whether an FMH 
is included in the data* If the FMH indicator is set in the RH, the DMH 
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should set the FflH indicator in the CCB relating to the transaction in 
which the input data contains an FflH. 

A second method of FMH handling is to provide the entire function in 
the DMH. The DMH should remove the FflH before passing the input data to 
the transaction and insert the necessary FflH into the output data. In 
order for the DMH to build the correct FflH for output, some form of 
private interface must be established between the system programmer and 
the application programmer. For example, the first byte of data 
following the CCB can contain unique values which request specific FflH 
functions such as "begin data set", "erase record", and so on. 

It is recommended that if FflH processing is required, the transaction 
(or preferably BflS) be used to provide the appropriate FflH. 


BATCH PROCESSING 


When running a batch logical unit, an optional consideration facing the 
system programmer is how to get the transaction identification to 
CICS/VS on the "begin data set" condition. The alternative methods are 
discussed below. 

The first method is for the DMH to recognize the "begin data set" 
condition by interrogating the FflH and by editing the transaction ID 
into the input data. This method is demonstrated in tne sample MCPs 
provided in Appendix F. 

The second method of providing the transaction ID is for the DMH to 
concatenate the "begin data set" chain with the first chain of the data 
set by using the SBTEOM macro. This method requires that the first 
chain of the data set contains the transaction ID. Alternatively, the 
transaction ID could be set with the TCTTE beforehand by means of a 
permanent TRANSID or by using DFHPC TYPE=RETURN,TRANSID=xxx. 


ERROR PROCESSING FOR BATCH LOGICAL UNITS 


During batch processing with a logical unit, there are certain logical 
errors from which the DMH cannot recover (for example, data set overflow 
or incorrect data set name). A transaction can be provided to handle 
these error conditions. If the transaction builds the data set on the 
TCAM queue and ends before the data set is transmitted, an error 
transaction should be created. The DMH should generate the appropriate 
error message or pass the SNA sense bytes to this error transaction, 
which then handles the error condition. If the transaction which builds 
the data set remains active throughout the transmission of the data set 
to the device, the transaction could be coded to recognize the error 
indicators passed to it from the DMH, rather than creating a separate 
error transaction. 


ERROR PROCESSING 


All error conditions, other than logical errors, are handled by the DMH. 
The OS/YS TCA M System Programmer*s Guide contains a discussion on the 
handling of the various sense codes returned by SNA devices. The 
transaction is not involved in error processing and recovery. 
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ICAM APPLICATION PROGRAM INTERFACE 


The TCAM application program interface is a portion of the TCAM message 
control program (MCP). It consists of two types of control blocks, the 
process control block (PCB) and the TPROCESS block. 

The PCB defines the application program interface of a 
partition/region in the system using TCAM. Its purpose is to control 
communication and storage protection across partition/region boundaries. 
It also defines the user—written message handier (ME) responsible for 
processing messages to and from the application program. Because a PCB 
is required for each application program running with the MCP, a PCB is 
required to define the CICS/OS/VS application program. 

The TPROCESS control block controls communication to and from the 
application program. A separate block is required for both input and 
output to the application program. A TPROCESS block is required for 
each input queue to CICS/OS/VS and for each output queue from 
CICS/OS/VS. In CICS/OS/VS, there are corresponding terminal control 
table line entries (TCTLEs) for each input queue and for each output 
queue (that is, for each TPROCESS block). 

DD cards (such as those shown in Figure 5.3—1) are used to correlate 
the TCAM control blocks with the CICS/OS/VS control blocks. The 
CICS/OS/VS terminal control table contains the DCB. The DDNAME 
specified in the terminal control table macro instruction (DFHTCT 
TYPE=SDSCI,DDNAMB=name) names the DD card* In the DD card, the QNAME 
field names the TCAM TPROCESS block. 

No exceptions are required for CICS/OS/VS to the TCAM application 
program interface just described. For additional information, refer to 
the OS/VS TCAM Application Programmer*s Guide . 


MCP (TCAM) MPP (CICS/OS/VS) 



Figure 5.3—1. DD Card Correlation of TCAM and CICS/OS/VS Control Blocks 


Chapter 5.3. The CICS/OS/VS TCAM Interface 


511 






C ICS/OS/VS/T CAM INTERFACE 


A TCAM input process queue is considered to be a "line” to CICS/OS/VS. 
For each input process queue there is a CICS/OS/VS terminal control 
table line entry (TCTLE)• Note that TCAM requires the application 
program (CICS/OS/VS) to have a DCB for each TPROCESS block; separate 
TPROCESS blocks are required for input to and output from the 
application program. Therefore, each TCAM output process queue is also 
considered to be a line and has a corresponding CICS/VS TCTLE. Each 
TCTLE references its own DCB generated by the DFHTCT TYPE=SDSCI macro 
instruction in CICS/VS. 

The CICS/OS/VS terminal control table terminal entries (TCTTEs) 
define the terminals associated with a particular line entry (TCTLE). 

For each physical terminal communicating with CICS/OS/VS through TCAM, a 
corresponding TCTTE containing the terminal identification must be 
associated with a TCTLE. Duplicating individual TCTTEs for both the 
input TCTLE and the output TCTLE is avoided by attaching a single, 
special TCTTE to the input TCTLE and attaching all the individual TCTTEs 
to the output TCTLE. Although attached to the output TCTLE, they are 
used for both input and output processing. 

Each input record from TCAM must contain the source terminal 
identification. Using this identification as a search argument, the 
corresponding TCTTE can be located by CICS/OS/VS by comparing against 
the NETNAME value for each TCTTE. 

I Note : The usual way of ensuring that the input records contain the 
| source terminal identification is to specify OPTCD=W in the CICS/VS 
| DFHTCT TYPE=SDSCI macro. If this specification is omitted, the TCAM 
| user is responsible for ensuring that the record contains a suitable 
| source terminal identification. 

Using the POOL feature (POOL=YES of the DFHTCT TYPE=LINE macro 
instruction) , it is possible to establish a pool of common TCTTEs on the 
output TCTLE that do not contain terminal identifiers. As required, 
terminal identifiers are assigned to the TCTTEs or removed from 
association with the TCTTEs. This POOL feature necessarily imposes a 
number of restrictions and should be thoroughly understood before being 
implemented. For additional information, see the discussion of the POOL 
operand in the section on "Line Pool Specifications 11 . 


DATA FORMAT 


When TCAM is specified, CICS/OS/VS assumes that the user transaction 
data passed to it from the TCAM queue is in the proper format to be 
passed directly to the user task. Except for the removal of the source 
terminal identification and the two—byte CCB if on a TCAM SNA line, 
CICS/OS/VS does not alter the data it receives. It is the user's 
responsibility (through his MCP) to properly prepare the data, such as 
translating to EBCDIC, removing FMHs, stripping line control characters, 
and deblocking. The user may optionally bypass the CICS/OS/VS routine 
that removes the source terminal identification by returning from the 
user—written input exit (XTCMIN) in TCP with a displacement of zero 
bytes. 

Similarly, CICS/OS/VS assumes that the user transaction data passed 
to it for TCAM has been properly formatted for direct placement on the 
TCAM output process queue. Except for the insertion of the destination 
identification, the CCB, and the data stream control characters, 
CICS/OS/VS does not alter the data it receives. It is the user*s 
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responsibility (through his MCP) to properly prepare the data for the 
destination terminal, such as by translating and inserting line control 
characters. 

Optionally, BMS can be used with TCAM to prepare the input data for 
the user task and the output data for the specific terminal type. When 
BMS is required with TCAM, the TRMTYPE operand in DFHTCT TYPE=LINE or in 
DFHTCT TYPE=TERMINAL must indicate the specific terminal type for 3270 
and 2260 data streams. TRMTYPE-TCAM can be used to obtain EBCDIC data 
stream support. For BBS support within SNA, the TCAMFET=SNA and SESTYPE 
operands must also be specified in DFHTCT TYPE=LINE and in DFHTCT 
TYPE=TERMINAL, respectively. 


LOGIC FLOW 


The following is a generalized description of the sequence of events 
that occurs in CICS/OS/VS when interfacing with TCAM. 

INPUT STEP ACTION 

A TCAM notifies CICS/OS/VS that it has data for a 

particular input TCTLE by posting its ECB. 

B CICS/OS/VS gets a TIOA and attaches it to the 

special input TCTTE in the TCTLE. 

C CICS/OS/VS issues a READ to TCAM which results in 

TCAM passing the data over the partition or 
region boundaries to the CICS/OS/VS TIOA. 

CICS/OS/VS indicates at this time that it has 
data to process. (See Figure 5.3—2) 

D The input TCTLE points to the corresponding output 

TCTLE in response to the OUTQ specification of 
the DFHTCT TYPE=LINE macro instruction. 

E The individual TCTTBs on the output TCTLE are 

searched for a matching source terminal netname. 

If POOL=YES has been specified, a free TCTTE is 
assigned to this source terminal identification. 
(See Figure 5.3—3). 

F If an input user exit (XTCMIN) has been specified, 

CICS/OS/VS links to the user exit routine where 
the user may edit input data prior to passing it 
to a task (see XTCMIN in "TCAM User Exits".) 

If no exit has been specified, CICS/OS/VS removes 
the eight—byte source terminal identification field 
inserted by TCAM. For SNA devices, the input 
communication control byte (CCB) is removed. 

No other editing of the data is performed. 

G A check is made to determine whether a task is 

attached to the individual TCTTE. If not, go to H. 

If a task is attached, a check is made to see if 
the task has issued a READ. If a READ request 
exists, go to Step J. If not, CICS/OS/VS halts the 
processing of data in the queue until the TCTTE 
is available or the attached task issues a READ. 


Chapter 5.3. The CICS/OS/VS TCAM Interface 


513 



ACTION 


INPUT STEP 


H CICS/OS/VS attaches the appropriate task- A 

user exit is available prior to the actual attach. 
(See XATTACH in ”TCAM User Exits. 11 ) 

If the task could not be attached (for example, 
a “'maximum task" or ,f short on storage” 
condition exists), CICS/OS/VS remembers it has data 
to process and exits DFHTCP. 

I Once a task is attached, CICS/OS/VS stores the 

TCAH segment identifier in the TCTTE (if segment 
processing was specified by including the C 
parameter in the OPTCD operand of the DFHTCT 
TYPE=SDSCI macro instruction). 

J CICS/OS/VS passes control to the attached task. 


TCAM input 
process queue 



Figure 5.3-2. CICS/OS/VS Issues A TCAM Read 
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OPTPOT STEP 
A 

B 

C 


0 


B 


P 


ACTIO8 

The user issues a WHITE request in his 
application progran. 

The TCP terminal scan recognizes the WHITE 
request. 

CICS/OS/VS checks whether an output user 
exit (XTCMOUT) has been specified. If specified, 
CICS/OS/VS links to the user exit routine, 
where the user mar edit his output data prior 
to passing it to TCAH. (See the discussion of 
XTCH03T in "TCAH User Exits.") 

CICS/OS/VS checks the four—byte TCTTE field 
TCTTEDBS for a destination saved as a result 
of DEST=NAHE or DEST=XES having been specified 
in the DFHTC TYPE=WBITE macro instruction. 

If present, CICS/OS/VS inserts it in the eight—byte 
destination field and left justifies the field, 
padding clanks to the right. Otherwise, 

CICS/OS/VS moves the source terminal netnaae 
from the TCTTE to the destination field. 

CICS/OS/VS moves the communication control 
byte (or bytes if TCAM SNA) into the ninth byte 
(ninth and tenth bytes if TCAH SMA) of the TCAH 
work area. See "TCAB Devices." 

CICS/OS/VS issues a TCAH WHITE to transfer the 
data to TCAH. 


6 After checking for successful completion of the 

WHITE to TCAH,CICS/OS/VS posts the user task 
"dispatchable” if a task is still attached to the 
TCTTB. Otherwise, CICS/OS/VS frees the TCTTE 
for a new task. 
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TCAM input 
process queue 



Figure 5.3-3. After TCAM Bead, CICS/OS/VS Attaches TIOA To 
Corresponding TCTTE 

TERMINAL ERROR PROGRAM 


The CICS/OS/VS/TCAM Interface implementation has resulted in the 
expansion of the CICS/OS/VS terminal error program (DFHTEP) error codes 
and conditions. The following errors and actions unique to TCAM and 
which should be considered in DFHTEP are: 


Error Code 
•87* (TCEMUI) 


X * 9F * (TCEMIDR) 


Condition 


Action 


Unsolicited input 

Terminal "Receive Only" 
Terminal "Out of Service" 
Task has not issued a read 
No available TCTTE from 
pool 


a 

a,b 

(no default) 
(no default) 


TCAM has issued an invalid c 

destination return code to 
CICS/OS/VS. 


where: 

a = Release TCAM TIOA (X*80* at TCTLEECB+2) 
b = Terminal out of service (X*08* at TCTLEBCB+1) 
c = abend transaction (X*04* at TCTLEECB+1) 
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MESSAGE ROUTING 


The DEST operand of the DPHTC TYPE=WRITB macro instruction can be used 
to route an output message to a destination defined by the user in the 
TCAM MCP. This operand can be used to send a message to a destination 
other than the source terminal (such as to another terminal, a list of 
terminals, or another application program). 

If DEST=name is specified, "name" is stored in the four—byte field 
TCTTEDES. If DEST=YES is specified, it is the user*s responsibility to 
have placed the destination name in TCTTEDES prior to issuing the WRITE 
macro instruction. 

CICS/OS/VS moves the data from TCTTEDES into the destination 
identification field prior to placing the data on the TCAM output 
process queue. The user may bypass the CICS/OS/VS routine that inserts 
the destination field by taking the XTCMOUT user exit and returning to 
CICS/OS/VS from the exit with a displacement of zero. In this case, the 
user must ensure that the TCAM header is properly formatted for output. 

If the DEST operand is omitted, CICS/OS/VS inserts the source 
terminal NETNAME from the TCTTE into the destination identification 
field. 


SEGMENT PROCESSING 


The CICS/OS/VS/TCAM Interface supports TCAM segment processing, except 
when BMS is used. It permits segments of a message to be forwarded to 
CICS/OS/VS rather than waiting for the entire message to be received. 

If the user specifies segment processing (by including the parameter M C" 
in the OPTCD operand of the DPHTCT TYPE=SDSCI macro instruction), 
CICS/OS/VS passes the segment to the user and places the one—byte 
position field control byte in the TCTTE field labeled TCTTBTCM. 
Similarly, on output, the user must supply the control byte in TCTTETCM 
for CICS/OS/VS to pass to TCAM. If multiple terminals have been defined 
for one output line (that is, multiple terminals related to one TPROCESS 
queue), the user must ensure that an entire message is passed to TCAM 
for a specific destination before putting the first segment for another 
destination on the queue. In other words, an error is returned to the 
user if a PUT first segment to destination A is followed by a PUT first 
segment to destination B. For additional information on segment 
processing, refer to the discussion of the OPTCD operand of the 
application input and output DCB in the OS/VS TCAM Application 
Programmer^ Guide . 


LINE POOL SPECIFICATIONS 


In generating the TCAM message control program, the user defines each 
physical terminal and logical unit to TCAM by means of a TCAM TERMINAL 
macro instruction. Because CICS/OS/VS also reguires terminal 
definitions, the user must prepare a terminal control table terminal 
entry (TCTTE) for each terminal or logical unit in a DFHTCT 
TYPE^TERMINAL macro instruction. As a result, a one—for-one correlation 
exists between terminal definitions in TCAM and in CICS/OS/VS. 

In a highly restricted environment, this duplication of terminal 
definitions can be reduced by using the POOL feature (DFHTCT 
TYPE=LINE,POOL= r YES) and by specifying LASTTRM^POOL in DFHTCT 
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TYPE=TERMINAL on the last TCTTE. Instead of a one—for—one relationship 
a "pool 11 of generalized TCTTEs is defined for a TCAM process queue 
(line). When a transaction is received over the TCAM "line," a search 
is made for an available TCTTE in the pool. When one is found, it is 
assigned the source terminal identification and netname for the duration 
of the task. Upon completion of the task, the TCTTE is available for 
reassignment. If there are no available TCTTEs to handle the next 
transaction from the line, the line remains locked until a TCTTE becomes 
available through task completion. The number of TCTTEs in the pool 
influences the degree of multitasking. 

| The system programmer should consider providing enough terminal 
| entries in the pool to avoid an "unsolicited input" condition (see "TCAM 
I Queues", below) because there is no available entry in the pool. When 
| DFHTCAM scans for a free entry, it will not scan the entire table 
| because it carries a pseudo end—of—table value. Therefore, unused 
| entries at the end of the table will never be referred to. 


Line Pool Restrictions 


The user must be aware of the following line pool restrictions: 

1. Because of certain device dependencies within CICS/OS/VS, only one 
terminal type is permitted for each TCAM line (process queue). 

| 2. Automatic task initiation (ATI), transaction routing, and BMS 

| message routing are not applicable in the pool environment. If ATI 

| is required for certain functions and the user still wants to use 

I pooling, the system programmer should consider using a special 

| queue of non—pooled entries that could be used for ATI. For 

| example, 3270 displays could be put on a pooled entry, and 3270 

| printers on a non-pooled queue to cause ATI to the printers. 

3. Statistics are accumulated for each TCTTE in the pool; however, the 
statistics cannot be correlated to the physical terminals or 
specific logical units. 

4. Only one sign-on can exist for all terminal entries in a given line 
pool at any one time. The first sign-on received by CICS/OS/VS is 
propagated to all terminals in the pool. Any subsequent sign—on is 
rejected. A sign-off clears the sign—on data from all terminal 
entries in the pool; a subsequent sign-on is then accepted. 

5. Terminal, line, and control unit requests by the master terminal 
are invalid for pooled terminals. 

| 6. Pseudo—conversational line pool implemented with an invalid RETURN 

| transaction identification. 


LINE LOCKING 

Two types of line locking can occur: 

1. A temporary lock that resolves itself in time, and 

2. A permanent lock that remains permanent unless the user takes 
action in his terminal error program. 
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A temporary line lock occurs when no TCTTEs are available in the pool 
and a new transaction appears on the input queue. CICS/OS/VS locks the 
queue until an existing task completes execution, thus freeing a TCTTE. 
In this case, the completion of existing tasks is not dependent upon 
additional input from the gueue. 

A permanent line lock can occur when multiple reads are required to 
complete a task. For example, assume that there are two TCTTEs in the 
pool, that a task is attached to each, and that the messages in the 
input queue are in the following order: 

• Message #1 for a third transaction 

• Subsequent messages for the two active tasks 

Because no TCTTE is available in the pool for the third transaction, 
it must wait for a task to complete for a TCTTE to become available. 
Because the TCAM input queue is processed sequentially, tasks 1 and 2 
are unable to receive their subsequent messages. Hence, they cannot 
complete, and the gueue remains permanently locked. 


TCAM QUEUES 


Because a queue is a sequential data set, the second message on the 
queue cannot be retrieved until the first message has been processed. 

To keep messages flowing smoothly through the queue, it is essential 
that each message be processed as soon as it arrives. In the 
CICS/OS/VS/TCAM Interface, "processing the message" means detaching the 
message from the special input TCTTE and attaching it to the individual 
TCTTE correlated to the actual physical terminal or logical unit. Each 
individual TCTTE may be considered to be a "destination” for the purpose 
of this discussion. 

If a particular destination (TCTTE) is not ready to accept the 
current message on the queue, the gueue necessarily ••locks* 1 until the 
destination can accept the message. Queue locks are only a problem when 
a queue is serving more than one destination. Then, if a queue locks, 
any new transaction on the queue, or messages queued for existing tasks, 
are not processed until the required destination has accepted the 
current message. 

Because queue locks can adversely affect system performance, it is 
important that the user understand their cause and effect. Proper 
configuration of TCAM process gueue and CICS/OS/VS terminal control 
tables reduces the occurrence and duration of queue locks to a minimum. 

The maximum number of terminals that can be attached to one queue is 
governed by the amount of activity expected and by the response time 
required from the system. It is suggested that, for high activity and 
low response times, the number of terminals should not exceed twenty- 
five. It should be noted that only a real performance test can verify 
whether this figure is acceptable. 

Because TCAM can read ahead from the terminals, it is possible for 
TCAM to present to CICS/OS/VS a new transaction message destined for a 
TCTTE that is already processing a task. Also, TCAM can present a 
message for an existing task prior to that task issuing a READ request. 
In either case, CICS/OS/VS cannot "process" the message (as described 
above) until the TCTTE is ready to accept the new TIOA. Such input is 
called ”unsolicited input.” 
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Five conditions can produce unsolicited input: 

1. The CICS/OS/VS TCTTE for which the data is destined is *OUT OF 
SERVICE 1 * 

2. The CICS/OS/VS special input TCTTE for the associated input queue 
is 1 OUT OF SERVICE*. 

3. The CICS/OS/VS TCTTE for which the data is destined is in RECEIVE 
status. 

4. The CICS/OS/VS TCTTE for which the data is destined has an 
associated task: that has not issued a READ and the period of time 
indicated by the NPDELAY specification has expired. 

5. A terminal in a pool has entered data and is unable to find an 
available TCTTE* 

In all cases, the action taken by the CICS/OS/VS/TCAM Interface is to 
place the input line OUT OF SERVICE and attach DFHTACP to process the 
error condition. 

The default action taken by DFHTACP (which can be altered by a user- 
written DFHTEP) for conditions 1, 2, and 3 is to discard the data and 
place the input line IN SERVICE. No default action is taken by DFHTACP 
for condition 4 or 5; therefore, the input line is placed IN SERVICE but 
with the same message still to be processed, thereby preventing 
CICS/OS/VS from reading any subsequent messages from the input queue. 

To allow processing of input to continue, DFHTEP may take appropriate 
action. If the input line is placed IN SERVICE by DFHTEP, the 
CICS/OS/VS/TCAM Interface retries the operation; in this case, a count 
mechanism is recommended in DFHTEP to prevent a loop in the event that 
the task never issues a READ or a TCTTE never becomes available. 
Alternative action, perhaps when a count limit is reached, might be to 
abend the task, dispose of the data, and place the line IN SERVICE. For 
further information concerning DFHTEP, see “Terminal Error Program 11 in 
Chapter 4.2. 

The problem of unsolicited input caused by condition 5 can be 
eliminated entirely by having a separate TCAM input process queue for 
each CICS/OS/VS terminal (TCTTE). However, as the number of terminals 
increases, this solution may quickly become prohibitive in terms of main 
storage requirements. 

The user should analyze the type of traffic that is anticipated over 
the queues. If a 2770 Data Communication System or a 2780 Data 
Transmission Terminal is to read in volumes of cards, separate queues 
should be considered for these devices. The asynchronous transaction 
processing (ATP) function in CICS/VS should be seriously considered for 
processing batches of data to minimize the time between task READ 
requests. For conversational traffic with short-lived tasks, the 
sharing of queues is certainly feasible. The same TCAM output process 
queue can be specified for multiple input process queues. (See the 
discussion of the DFHTCT TYPE=LINE,OUTQ=symbolic name specification in 
Chapter 3.2 of this manual.) 

The user need not be concerned with locking of the TCAM output 
process queue, because TCAM requeues the data by final destination once 
it arrives over the output queue. 

It is possible for the TCAM output process queue to become congested 
because of lack of queuing space. In this case, CICS/OS/VS has a WRITE 
to the queue outstanding until TCAM accepts the data. 
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| If the length of a message passed to a TCAM queue exceeds the queue's 
| block size (specified in the DCB), DFHTCAM will cause DFHTACP to be 
| attached with “output area exceeded” (error code X'BF'). 


TCAM DEVICES 


In the non—TCAM environment, the CICS/OS/VS terminal control program is 
responsible for polling and addressing terminals, code translation, 
transaction initiation, task and line synchronization, and the line 
control necessary to read from or write to a terminal. When TCAM is 
specified, terminal control relinquishes responsibility to the TCAM MCP 
for polling and addressing terminals, code translation, and line 
control. To take advantage of TCAM facilities, the user must accept the 
responsibility of coding in the MCP message handler functions such as 
code translation previously handled by the CICS/VS terminal control 
program. 

For some terminal services, it is necessary for CICS/OS/VS to pass 
the user request on to the TCAM MCP message handler. A communication 
control byte (two bytes if TCAM SWA) in the TCAM work area has been 
established for this purpose* It is passed to TCAM along with the 
eight-byte destination name field. Based on the communication byte, the 
user must execute the proper MCP message handler macro instructions to 
accomplish the necessary function* 

The terminal services parameters that do not set bits in the 
communication control byte are WRITE, WAIT, and SAVE. Bits in the 
communication control byte are set for the 2260 parameters WRITEL and 
READL, for the DISCONNECT, FMH, CONVERSE parameters, and for the LAST 
parameter on the WRITE macro* 

The CICS/OS/VS/TCAM Interface does not support the RESET parameter or 
the 3270 parameters READB and COPY. 

All messages to TCAK from CICS/OS/VS are prefixed with the standard 
CICS/OS/VS/TCAM communication area. This is one byte for the non—SNA 
TCAM interface, and two for the TCAM SNA interface (that is, when 
TCAMFBT=SNA is specified in DFHTCT TYPE=LINE). This area is used to 
convey special requests and options to TCAM that cannot be used within 
CICS/OS/VS (such as WRITEL to a 2260). 

The format of the communication area is: 


First bvt e 


FMH present in stream X'OI* 
Extended CCB (2 byte CCB) X'04' 
DISCONNECT request X'08 1 
READL (read keyboard) XMO* 
WRITEL (write keyboard X»20» 


Second bvte (present if extended CCB is on) 


Last output from transaction X'01 1 (WRITE,LAST) 

READ requested after this WRITE X'02* (WRITE,READ request or CONVERSE) 
All other flags are reserved and are set to zero. 
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GBNBBALXZBD TCAM MESSAGE FORMAT 


Messages passed to CICS/OS/VS from TCAM and vice versa have the 

following format: 

V " ' "" 1 ' ~ ■ 

| destination | CCB | device dependent data | FMH | message f 

i » 


8 bytes 2 bytes x bytes y bytes 

(optional) (device dependent) (SNA only) 
(SNA only) 


destination = destination name (8 bytes) taken from TCTTE's 

netname parameter or from BEST specification 
on output. 

CCB = communication control byte(s) 

This determines the options specified for 
the message (for example, whether an PMH is 
present or not. The length of the CCB varies 
from: 

0 bytes (input message non-SNA) 

1 byte (output message non—SNA) 

2 bytes (input/output messages — SNA) 

device dependent data - dependent on the device — 2260, 3270, or other 

See the following sections on 
the relevant devices. 

FBI! - function management header 

SNA only = length in first byte 
non-SNA = not applicable. 

aessage » user data 


ICAR WITH 2260 DISPLAYS 


The CCB and device-dependent data for 2260 devices have the following 

format: 
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f-------» 

| CCB1 | CCB2 | device dependent data | 

II 112 | 

L_t 


(SNA only) 


CCB contains: 


device dependent data: 
Byte 1 


Byte 2 


X'08* DISCONNECT request 
X»10* READL 
X *20' WRITEL 


X'AO" Set WRITE direct 
X»B0* LINEADR request 
X'EO* ERASE request 

Line addressing character (if specified) 


TCAM WITH 3270 DEVICES 


The CCB and device-dependent data for an input message from TCAM to 
CICS/OS/VS have the following format: 

[ CCB1| CCB2 | AID | CURSOR J 
| 1 byte | 1 byte | 1 byte | 2 bytes | 

i_i 


(SNA only) 

The CCB is present for TCAH SNA lines only. 

The CCB and device dependent data for 3270 output messages from 
CICS/OS/VS to TCAM have the following format: 

| CCB1 | CCB2 | 1 | 2 | 3 | 

| 1 byte j 1 byte | 1 byte j 1 byte | 1 byte | 

i_• 


(2 bytes — SNA) device dependent data 

(1 byte - non SNA) 

1 Escape character 

2 Command 

3 WCC (write control character) 

Note: For 3270 SDLC devices, the escape character must be removed by 
the message handler. 

All SOB% status messages input to CICS/OS/VS are passed to 
DFHTACP/DFHTEP. 

Terminal control copy and read buffer requests are not supported by 
the CICS/OS/VS/TCAH Interface. 

In addition to normal read/write functions, the ERASBAOP, CTLCHAR, 
OCTRAN, and COHPAT operands are also valid for the 3270* 
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All 3270 printer scheduling and error handling is provided by the 
TCAM message handler. 


TCAM USER EXITS 


| Three user exits are available to the TCAM user. The two methods 
| available for using user exits are described in Chapter 6.2. The 
I following information is based on the new user exit interface. 

| The tnree user exits available are XTCATT, XTCTIN, and XTCTOUT. 

| Whereas XTCATT is shared by other users, XTCTIN and XTCTOUT are 
| available only to TCAM users and are used in place of the XTCIN and 
| XTCOUT exits used by others. 


| TASK ATTACH USER EXIT (XTCATT) 

I 

| The XTCATT exit is invoked prior to issuing a task control ATTACH for a 
transaction identification received in response to polling. In the 
CICS/OS/VS/TCAM Interface this information is received over the TCAM 
input process queue. 


| INPUT USER EXIT (XTCTIN) 

I 

| The XTCTIN exit is invoked following the completion of any input event, 

| (that is, after the individual TCTTE is located, but just before 
| CICS/OS/VS checks to see if a task is attached to the TCTTE). At this 
time, the LIOA contains the 12—byte storage accounting field and the 
work area from TCAM. The work area contains an eight—byte source 
terminal identification header, the CCBs if TCAM SNA, and the work unit 
| (user data). TIOABAR (register 4) points to the line I/O area 
| containing the origin field and user transaction data. TCTTBAR 
| (register 2)points to the corresponding TCTTE for this message, and the 
TCTTEDA field within the TCTTE points to the TIOA which is to be used to 
contain the edited message. 

The user has two options in returning from the user exit. If the 
| user returns with a return code of 0, CICS/OS/VS removes the eight—byte 
source terminal identification field and the CCBs if TCAM SNA input. 

Upon completion, the TIOA contains the 12—byte CICS/OS/VS storage 
accounting field and the work unit. (See Figure 5.3-4.) 

| If the user returns from the exit with a return code of 4, CICS/OS/VS 
does not alter the data in the TIOA. It is then the user's 
responsibility to handle the TCAM header. 

For a discussion of TCAM work areas and work units, refer to the 
OS/VS TCAM Application Programmer's Guide . 


| OUTPUT USER EXIT (XTCTOUT) 

I 

| The XTCTOUT exit is invoked for output events at the point prior to 
placing data on the TCAM output process queue. 
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The user has two options in returning from the exit. If the user 
| returns from the exit with a return code of 0, CICS/OS/VS inserts in the 
TIOA, between the 12-byte CICS/OS/VS storage accounting field and the 
work unit, a TCAM header consisting of an eight-byte destination field 
and the communication control byte or bytes required for TCAM. If the 
I user returns from the exit with a return code of 0, CICS/OS/VS obtains 
an LIOA if necessary, inserts a TCAM header consisting of an eight byte 
destination name, communication control area, and any device dependent 
data, and copies user data from the TIOA. The LIOA is then used to 
transmit the data to the TCAM queue. If the user returns from the exit 
| with a return code of 4, CICS/OS/VS bypasses this insertion routine. It 
is then the user*s responsibility to ensure that the TCAM header is 
properly formatted. 

Figure 5.3—4 shows the composition of the TCAM work area and the 
CICS/OS/VS line and terminal input/output areas (LIOA and TIOA) at the 
various stages of operation. On input (1.), it shows the information 
available from the TCAM input process queue. At 2., the CICS/OS/VS/TCAM 
interface has obtained a line I/O area and has received the TCAM message 
into that area. This is the state when input event completion has just 
taken place. If default editing is then performed, a TIOA (as at 3.) is 
obtained and the relevant data is copied from the LIOA in 2. to this 
TIOA (that is, the origin field, CCB (if any), and device dependent data 
are removed). This TIOA is then given to the user. On output, a TIOA 
(as at 3.) is provided by the user. The CICS/OS/VS/TCAM interface 
obtains an LIOA (at 4.) if necessary, and inserts a destination name, a 
CCB, and device dependent data before copying the user transaction data. 
This information, beginning at the start of the work area, is placed in 
the TCAM output process queue. 
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1. TCAM Work Area from 
the input process queue 


8 bytes - 
Origin 
field 


'cceTj FMH 


I (optional) | _ User transaction data 


Start of 
work area 
\ 

\ 

\ 


Start of 
work unit 
\ 

\ 


12 bytes 


8 bytes ■ 


\. 


End of 
work area 
\ 

\ 

\ 


LIOA after input 


. Storage 

| accounting 

Origin CCB | FMH | 

| fie,d 1 | (optional) | 

User transaction data | 

event completion: 


k 

\ 

/ 

/ 


lioa\ 

\ 

\ 

/ 

/ 



V 

\ 

/ 

/ 



\ 

\ 

/ 

/ 


\ / 


• x bytes - 


3. TIOA after CICS editing 


Storage 

' FMH j 


i 

1 

accounting 

| (optional) | 

User transaction data 

_1 


A 


\ 


'TIOA 


/ 


/ \ 


\ 


4. LIOA before output Event 
Completion after CICS 
insertion routine: 


12 bytes — 
Storage 

accounting i 

8 bytes —► 
Destination 

1 1 

V 

CCB 

u 

- 1 \ 
FMH | \. 

(optional) ( User transaction data | 

k i 



LIOA 


The work area is placed on 
the TCAM output process queue 


Start of 
work area 


Communication 
control byte(s) 

+ device dependent 


End of 
work area 


Figure 5.3—4 . Stages of TCAM Work Area and CICS/OS/VS Input/Output 
Areas 


The TCAM origin field contains the source terminal network name 
(netname) . 


Tne TCAM destination field contains the destination identification 
for TCAM to route the data properly. 

If the user specifies the output user exit and returns from the exit 
| with a return code of 4, CICS/OS/VS does not alter the TIOA work area. 
The user must provide the data length at TIOATDL and must prepare the 
work area for TCAM , including the eight—byte destination field and the 
communication control byte (bytes if TCAM SNA). 


CICS/OS/VS/TCAM STARTUP 


The TCAM MCP must be in operation prior to completing CICS/OS/VS system 
initialization. When the user brings up CICS/OS/VS with the 
CICS/OS/VS/XCAM Interface, CICS/OS/VS checxs for the presence of a TCAM 
partition/region and issues the operator message: 

DFH1500 - CICS CHECKING FOR TCAM MCP 
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If CICS/OS/VS discovers the MCP is not operational, the following 
messages are issued: 


DFH1520 - TCAM MCP IS NOT CURRENTLY AVAILABLE 
DFH1520 - REPLY RETRY OR CANCEL OR CONTINUE 

The operator must then respond: 

RETRY 

when the TCAM partition/region becomes active; or 
CANCEL to terminate CICS/OS/VS; or 
CONTINUE 

to continue initialization of CICS/OS/VS in the absence of the TCAM 
partition/region. 

If the operator responds CONTINUE, all DD cards that refer to a TCAM 
queue must have been previously removed from the startup deck to avoid 
an abnormal termination of CICS/OS/VS. The CONTINUE response is 
applicable to a mixed BTAM/TCAM mode of operation when TCAM lines are 
not being used during execution of CICS/OS/VS. 


C ICS/OS/VS/TCAM ABB ND/RESTART 


If the TCAM message control program (MCP) terminates abnormally, any 
TCAM application programs currently active are automatically terminated 
abnormally, providing there is at least one open line group in the MCP. 
The CICS/OS/VS application program is no exception. For further 
information, see the relevant sections in the OS/VS TCAM Syste m 
Programmer^ Guide and in the OS/VS TCAM Application Programmer*s Guide . 
CICS/OS/VS does not provide RESTART capability. 


CICS/OS/VS/TCAM TERMINATION 


CICS/OS/VS is terminated in the normal manner. No modifications to 
termination procedures are required to support the CICS/OS/VS/TCAM 
Interface. If both CICS/OS/VS and TCAM are being terminated, CICS/OS/VS 
should be terminated first to avoid an abnormal termination of 
CICS/OS/VS. 


CICS/OS/VS AND TCAM: _PR OGRAM INTERRELAT IONSHIP 


Figure 5.3—5 illustrates the interrelationship between the TCAM message 
control program (MCP) and the TCAM application program. CICS/OS/VS is 
regarded as an application program by TCAM. 
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TCAM MCP 


3270 (Remote) 


CICS/OS/VS Application program 



DDLG3270 

DDLG2260 


DD Cards 
DD UNlT=xxx 
DD UNIT=(a, b) 


TCTLE 

DDNAME= 

QOUT1 


TRM2 

TRM1 

TCTTE 


DD cards 


//QIN1 

//QOUT1 

//R3270IN 


DD QNAME=RIS1 
DD QNAME-WIS1 
DD QNAME=R70I 


| //R3270OUT DD QNAME=R700 


Figure 5.3—5. TCAM Message Control and Message Processing Program 
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The following is an example of a TCAM message control program. This 
MCP shows the relationship between the MCP definition and the CICS/GS/VS 
terminal control table generation. It should not be construed as a 
typical or usable MCP for CICS/OS/VS. For further information on MCP 
definition for a variety of devices, refer to the OS/VS TCAM 
Installation and Migration Guide . An example of a CICS/OS/VS terminal 
control tanle for TCAM can be found in Appendix B. 


TCAM MESSAGE CONTROL PROGRAM (NON—SNA) 


MCPCICS 

TCAMINIT 


NO EX EC 
OPENLINE 


FINISH 


LG2260 


PG3270 


QPROC 


BIS 1 
WlSl 
R70I 
R700 
T32C 
S70A 

S70B 

S75A 

TRM 1 


CSECT 

INTRO DISK=NO, 

PROGID=TCAM/CICS, 

LUNITS=40, 

MSUNITS=20, 

KEYLEN=132, 

CR0SSRF=4 , 

DLQ=TRM1 , 

STARTUP=CY, 

TRACE=10, 

LINETYP=30TH, 

OLTEST=0 
LTR 15,15 

BZ OPENLINE 

ABEND 123,DUMP 

OPEN (LG2260, (INOUT) ,PG3270, (INOUT) ) 

TM LG2260 +48,DCBQFLGS 

BNO NOEXEC 

TM PG3270+48,DCBOFLGS 

BNO NOEXEC 

WTO *TIME TO START APPLICATION PROGRAM» 

READY 

CLOSE (LG2260,,PG3270) 

L 13,4(13) 

RETURN (14,12) 

DCB DS0RG=TX, 

MACRF= (G,P) , 

CPRI=S, 

DDN AME=DDLG2260, 

MH=T0TCAM, 

PCI= (N,N), 

BUFSIZE=464, 

INVLIST=(P0LLST1,,,POLLST2) ,TRANS=E3CD 
DCB DSORG=TX,MACRV= (G ,P),CPRI=S,DDNAME=DDPG3270, 

MH=MH3270,PCI= (N,N) ,BOFSIZE=464, 

INVLIST= (POLL70R,,) ,TRANS=EBCD 
PCB MH=TOCICS, 

BUFSIZE=464, 

RESER VE= (20) 

TTABLE LAST=TRM2 
TPROCESS PCB=QPROC,CUEU£S=MO 
TPROCESS PCB=QPROC 
TPROCESS PCB=QPROC,QUEUES=MO 
TPROCESS PCB=QPROC 

TERMINAL QBY=T,DCB=LG3270R,RLN=1,TERM=327C,QUEUES=MO 
TERMINAL QBY=T,DCB=PG3270,RLN=1,TERM=327R,QUEUES=MO, 
ADDR=616140402D,NTBLKSZ=1856,SECTERM=YES 
TERMINAL QBY=T,DCB=PG3270,RLN=1,TERM=327R,QUEUES=MO, 
ADDR=6161C1C12D,NTBLKSZ=1856,SECTERM=YES 
TERMINAL QBY=T,DCB=PG3270,RLN=1,T£RM=327R,QUEUES=MO, 
ADDR=E2E240402D,NTBLKSZ=1856 
TERMINAL QBY=T, 

DCB=LG2260, 

RLN=2, 


* 

* 

♦ 

* 

* 

♦ 

♦ 

* 

♦ 

* 


* 

* 

♦ 

* 

* 

♦ 

* 

* 

He 

* 

♦ 


* 


* 

He 

He 

♦ 

♦ 

♦ 
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TRH2 


POLLST1 
POLLST2 
POLL70R 


♦ 

TOTCAM 


♦ 

MH3270 


SOH 


TOCICS 


DCBOFLGS 



TERH=226L, 

♦ 


QOBUES=MO, 

♦ 


ADDR=FFFFFFFF, 

SECTERH=YES 

♦ 


TERHINAL QBY=T # 

* 


DCB=LG2260, 

♦ 


RLN=2, 

♦ 


TERH=226L, 

♦ 


ADDB=FFFFFFFF, 

QDEDES=HO 

♦ 

INVLISI 

ORDBR=(TRH1+02) 


INVLIST 

ORDER = (TRJJ2+02) 


INVLIST 

ORDER = (T32C—C1C17F7F2D 

,S70A+C1C140402D, * 


S70B+C1C1C1C12D, 

♦ 


S75A+C2C27F7F2D, 

EOT=37 

S75A+C2C240402D), * 

STARTMH 

LC=OOT 

2260 HH 

INHDR 

CODE 


PROCESS INCOHING HSG HEADER 

FORWARD 

DEST=C'RIS1• 


INMSG 


PROCESS INCOHING COMPLETE HSG 

INEND 


END OF INCOMING SECTION 

OOTHDR 


PROCESS OOTGOING HSG HEADER 

OOTEND 


END OF OOTGOING SECTION 

STARTER 

LC=OUT,CONV=YES,STOP=YES 3270 HH 

INHDR, 


PROCESS INCOHING HSG HEADER 

MSGTYPE 

X*6C' 

IS IT A STATOS MESSAGE 

B 

SOH 

IF SO, BRANCH ROOND 

MSGTYPE 


ALL OTHER HSGS TO HERE 

HSG ED IT 

( (R,CONTRACT,SCAN, (2))) 

,BLANK=NO REMOVE COD? BYTES 

EQU * or DS OH 

CODE 


FORWARD 

DEST=C 1 R70I• 


INBUF 


INCOHING MSG SEGMENT SECTION 

INM SG 


SECTION FOR COMPLETE MSGS 

INEND 

OOTHDR 


END INCOHING SECTION 

SETSCAN 

1 


MSGEDIT 

((R#/SCAN)) 

REMOVE CC3 

MSGFORM 

CODE 

OOTBUF, 

OOTMSG 


SETS IN LINE CONTROL CHARS 

OOTEND 


END OOTPOT SECTION 

STARTMH 

INHDR 

LC=OOT 

HH FOR APPLICATION 

CODE 


TRANSLATE TO EBCDIC 

FORWARD 

DEST=PUT 

WRITE TO CICS 


INEND 

OOTHDR 

OOTEND 

EQO XMO* 

END 
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The IBM System/7 may be used under two line protocols in a CICS/VS 
environment. The chapter provides information on writing a transaction 
to IPL the System/7 on start/stop and BSC lines. 


ON A START/STOP LINE 


To initial program load (IPL) the System/7 from CICS/VS, the user must 
write a transaction that issues an automatic transaction initiation 
reguest to either interval control or transient data control. This 
transaction is usually initiated from the master terminal or from a 
sequential terminal. The initiated transaction is started on the 
System/7; it then writes the IPL records to the System/7. 

The IPL records are prepared by the user and consist of: 

• UZERO, a utility module 

• UTIPL, a utility module 

• System/7 storage load 

UZERO and UTIPL are provided in object deck form on the MSP/7 
distribution tape under member names CAAUZERO and CAAUTIPL, 
respectively. If link—edited into the user—written application program, 
UZERO and UTIPL are available for transmission in a suitably translated 
format. 

The first two bytes of each of these modules contain a count of the 
number of characters in the remainder of the module. These two bytes 
must be placed in the user*s TIOA at TIOATDL by the application program. 
The remainder of the module is moved to TIOADBA. UZERO and UTIPL may 
then be transmitted to the System/7 by issuing terminal output requests 
with the WAIT option in the application program. 

The System/7 storage load is generated by the formatting utility 

(FORMAT/7) by specifying «PARM=TCOM» in the execute card of the 
formatting job step. The storage load is comprised of 80-character 
records that may be read using the transient data or file control 
facilities of CICS/VS and transmitted to the System/7 by issuing a 
series of terminal output operations with the WAIT option. If a DFHPC 
RETURN request is used to allow the System/7 to begin execution, the 
user must ensure that no automatically initiated transaction is 
scheduled to begin on the System/7 until at least 10 seconds have 
elapsed following execution of the DFHPC RETURN request. 

For more information concerning the preparation of IPL records for 
the System/7, see the publication IBM System/7 MSP/7 Host Program 
Preparation F a cili t ies II on Sy stem /3 6 0 or System/370: Assembler. 
Linkage Editor, Formatting Utility, and Source Preparation Program . 
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USING A BSC LINE 


CICS/VS supports the initial program load (IPL) of a System/7 with the 
binary synchronous communications adapter (BSCA) using a multipoint line 
only . This feature requires that a terminal entry (TCTTB) be generated 
which includes the following parameters: 

TRMTYPE=S/7BSCA, 

TRMSTAT=IPL , 

TRMADDR=label, 

F2ATURE=TRANSPARENCY, . . . 

The DFTRMLST pointed to by the TRWADDR parameter must specify an 
address in the form (SEL SEL DC1 DC1 ENQ ), where SEL is the System/7 
selection address. This logical terminal is used exclusively for the 
IPL of the System/7. One additional TCTTE is required for each logical 
terminal in the System/7. The number of logical terminals that reside 
in a System/7 is limited by the application program running in the 
System/7. 

No entry should be made in the polling list for the System/7 IPL 
logical terminal. 

To IPL the System/7 from CICS/VS, the user must write a transaction 
that issues an automatic transaction initiation reguest to either 
interval control or transient data control. This transaction is usually 
initiated from the master terminal or from a sequential terminal. The 
initiated transaction is started on the System/7; it then writes the IPL 
records to the System/7. 

The IPL records are prepared by the user and consist of the 
following: 


SUBIPL (the bootstrap loader) 

System/7 Storage Load 

SUBIPL is supplied with MSP/7* The System/7 Storage Load is written 
and assembled by the user. CARD format must be specified for the 
execution of FORMAT/7, the MSP/7 formatting utility. The user-written 
CICS/VS transaction that transmits the SUBIPL and the Storage Load 
records to the System/7 will use the following macro: 


DFdTC TYPE=(WRITE,WAIT,TRANSPARENT) 

For further information, see the manual MSP/7 Macro 
Library/Relocatable: Coding the Input/Output Macro s. 
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Ch a pter 5.5, 2260 Compatibility for the 3270 


This discusses the subject of running 2260—based transactions on the 
3270, and covers the following topics: 

• The two modes of 2260 compatibility — FORMAT and FULLBUF modes. 

• The entries required in the terminal control table to generate 2260 
compatibility support. 

• The data streams for the various models of the 2260. 

• The various screen techniques for entering data on the 2260. 

• Start-of—message indicator, new line symbol, line addressing, 2 84 8 
lock feature, and 2845/2848 tab feature in relation to the 2260. 

• How to initiate transactions from a 3270 in 2260—compatibility 
mode • 

2260 compatibility support for the BTAM—supported 3270 Information 
Display System allows the user to run currently operational 2260—based 
transactions from a 3270. 2260 compatibility is not supported for 3270s 

| operating through ACF/VTAM. 

During CICS/VS system generation, the user must request that 2260 
compatibility be included, thereby generating the necessary code to 
provide conversion of 2260 data streams from user-written application 
programs to the appropriate 3270 data stream format. When the 3270 
operates with a Compatibility“ transaction, incoming data from the 3270 
is converted and presented to the user—written application program in 
2260 format. In most cases, no changes are required to the user—written 
program. 

Because 2260 compatibility is specified by transaction as well as by 
terminal, non—2260—based transactions have full access to all facilities 
of the 3270. Only when a 2260-compatible transaction is attached to a 
2260—compatible 3270 does CICS/VS perform the editing of the input and 
output data streams. If the transaction is not specified as 2260 
compatible, or if the terminal is not specified as supporting 2260 
compatibility, no editing occurs for the data streams. In that case, if 
the data streams are not valid 3270 data streams, the results are 
unpredictable• 


MODES OF 2260 CO MPATIBILITY 


Two modes of 2260 compatibility operation are provided: FORMAT and 
FULLBUF. 

FORMAT mode takes full advantage of the 3270 formatting and data 
compression facilities, and is the preferred method of 2260 
compatibility, particularly for the operation of remote 3270s* However, 
some 2260 facilities cannot be supported under FORMAT mode. For 
information concerning which facilities are available, see "Screen 
Techniques." 

FULLBUF mode does not use the 3270 data compression facilities and 
must therefore be used when all lines of input data are desired. For 
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each operator interaction involving a data entry key (ENTER, PEI — 

?F12), the number of characters transferred is approximately equal to 
the total number of characters on the simulated 2260 screen. The exact 
number of characters transferred varies, depending upon whether the 3270 
is local or remote and which model of the 2260 is being mapped onto 
which model of the 3270. 

N ote : A terminal is considered to be in compatibility mode from the 

time a 2260—compatible transaction is initiated until (1) the CLEAR key 
is pressed, or (2) a 3270 native mode transaction is initiated. 

For local 3270 operation, the extra data transfer of FULLBUF mode 
should be transparent to the user with regard to response time. For 
remote 3270 operation, the response time is a complex function of the 
present method of 2260 operation and the line speeds used for the 2260 
and 3270; however, the increase in the response time (on a transaction 
basis) should be less than 20% at the same line speed. 


CICS/YS TABLE PREPARATION FOR 2260 COMPA T IBILIT Y 


Individual transactions can be flagged for FORMAT or FULLBUF 2260 
compatibility through the DFHPCT TYPE=ENTRY macro instruction. The mode 
of compatibility chosen depends on the 2260 functions reguired for the 
application programs that, are to run under this particular transaction 
code. 

The characteristics of the 2260/2265 terminal (which the 3270 display 
replaces) are specified by additional operands for the DFHTCT 
TYPE=TERMINAL macro instruction. They are as follows: 


COMPAT= (NO| (characters,lines,device,model)} 

The ••characters 11 parameter is used to specify the screen size of the 
2260/2265 terminal. Applicable parameter values are 240, 480, and 960. 

The "lines 1 * parameter is used to indicate the number of lines 
applicable to the 2260/2265 terminal or to insert new line (NL) symbols 
into the 3270 printer output data stream where NL symbols are not 
provided by the user in the output data stream. Applicable parameter 
values are 6, 12, and 15. The default value for a 960—character screen 
is 12. 

The "device" parameter is used to specify a 2260 or 2265 terminal or 
a 1053 printer. The default is 2260. Note that a specification of 
C0MPAT= (960,15) would result in an error condition, because the 2260 
(assumed by default) cannot support 15 lines. 

The "model" parameter is used to specify a model number for the 2260 
terminal being simulated- This parameter provides an interface for any 
user—written application programs that currently test the TCTTETM field 
before building device—dependent 2260 data streams. 

The FEATURE operand has been included in the CICS/VS DFHTCT 
TYPE=TERMINAL macro instruction to indicate the presence of 3270 
Information Display System features- These are, PTRADAPT, SELCTPEN, 
AUDALARM, COPY, DCKYBD, UCTRAN, and PRINT. The meanings of these 
parameters are: printer adapter, selector pen, audible alarm, copy 
feature, dual case keyboard, uppercase translation, and print request 
support respectively. 
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Ng-tg-; Printer adapter specifies the corresponding 3284 Model 3 Printer 
on the 3275 Display Station. A separate DFHTCT TYPE=TERMINAL macro 
instruction cannot be coded for the 3284 Model 3 Printer because the 
3284 Model 3 shares the buffer of the 3275 Display Station. 


22 60 MODEL—DEPENDENT DATA STREAM 


Some users require the capability of building 2260 device-dependent data 
streams. CICS/VS allows the user to build such data streams by 
providing the terminal type at TCTTETT in the terminal control table 
(TCT) and the terminal model number at TCTTETM in the TCT• 

The TCTTETT and TCTTETM fields always contain the 2260 or 2265 
terminal type codes and user—assigned model number (as specified in the 
DFHTCT TYPE=TERMINAL macro instruction) whenever a transaction flagged 
for CICS/VS 2260 compatibility is dispatched. At all other times, 
TCTTETT and TCTTETM contain the codes for the 3270 terminal. 


SCREEN TECHNIQUE S 


Various techniques have been used for entering data using a 2260 screen 
and keyboard. The following are examples of four basic techniques that 
may be used. 

1. Formatted 2260 screen technique; for example: 


► USER KEYED DATA X* X-CONSTANT DATA X 


X-X A 

X-X A 

X- X A 

X-X A 

X-~X- 


X- 

X--X 


X 


X-X 


X-X 


x- 


■x 


With this technique, the constant data is optional and is sent to 
the user at the start of the transaction. Either FORMAT or FULLBUF 
mode may be specified, depending upon the user*s formatting 
requirements. 

2. 2260 tab feature technique; for example: 


► NAME: 

INITIAL: 

STREET: 

NUMBER: 

CITY: 

STATE: 
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For CICS/FS 2260 compatibility operation, the colon—tab character 
combination is replaced by 3270 "unprotected attribute” characters. 
FORMAT mode may be specified if data is always keyed into every 
field. FULLBUF mode must be specified if any field is to be left 
blank. (Unlike the 2260, the 3270 does not transmit blank 
characters unless FULLBUF is specified.) If FULLBUF is not 
specified, any heading following the blank field is not transmitted 
to the application program. 


► NAME: JONES INITIAL: 

STREET: NUMBER: 

CITY: NEW YORK — STATE: 

J A 

1515 A 


FORMAT data stream: 



NAME:JONES INITIAL:J(NL) 

: 1515 (NL) 

:NEW YORK 

FULLBUF data stream: 



NAME:JONES INITIAL:J(NL) 

STREET: 

NUMBER:1515 (NL) CITY:NEW YORK 


3. "Endless screen" technique; for example: 



kith this technique, the 2260 screen is treated as unformatted. 

The operator keys off the screen, and, wrapping around to the start 
of the screen, overkeys any old data still there. The 2260 
transmits a data stream delimited by SMI (start of message) and EOM 
(end of message) characters, irrespective of any screen wrap¬ 
around. 

Either FORMAT or FULLBUF can be specified. In either case, CICS/VS 
ensures that the data stream is correctly ordered before sending it 
to the 2260^based transaction. 

With this technique, there is a difference in operation between 
FORMAT and FULLBUF modes only in the case of a 480—character 2260 
mapped onto a 480-character 3270. Use of FORMAT mode causes the 
loss of the last character of every 2260 output line. Use of 
FULLBUF mode limits the data loss to the last character position of 
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the last line hut at the expease of transferringa f ull 4 j 30 
characters (479 characters plus one attribute character) for each 
interaction involving a data entry key. 

It is the responsibility of the user to determine whether his 2260 
transaction can tolerate the loss of the last character of each 
output line. CICS/VS appends a blank character to the end of each 
2260 input line, except where the line is terminated prematurely by 
a new line (NL) symbol. 

••Change and enter' 1 technique; for example: 


► JONES 

1515 

J H 

OLD ROAD EAST 

- 

ORIGINAL 

NEW YORK 

N. Y. 10010 



RECORD 

► JONES 

J H 



1515 

OLD ROAD WEST 


UPDATED 

► 

NEW YORK 

N. Y. 10010 

- 

- 

RECORD 


The FORMAT data stream looks like this: 


JONES J H 1515 OLD ROAD WEST 


The FULLBOF data stream looks like this: 


JONES 

J H 

1515 

OLD ROAD WEST 

NEW YORK 


N.Y. 

10010 
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The 2260 transaction sends an existing record to the screen. After 
making any necessary corrections to data fields, the operator 
depresses the ENTER key; the 2260 transaction receives the entire 
record in its updated version. 

With this technique, FULLBUF must be specified for this transaction 
to ensure that the transaction receives a 2260-compatible data 
stream. 

Note s If binary zeros instead of blanks are used in the output data as 
filler characters, they will be stripped out by the control unit when 
read back from the 3270. This makes data appear to be compressed. 


START OF MESSAGE INDICATOR (SM I) 


For the 2260, X'hA* is displayed as the SMI (►) character. If the SMI 
character is contained in an output data stream, it is displayed on the 
3270 screen as follows: 

Country SMI Symbol 


U. S 4 A. 
U.K. 

France 

Germany 


At the user*s discretion, a different character may be specified 
during CICS/VS system generation to represent the SMI. The character 
chosen remains the same for all transactions. 

If an SMI character is not placed on the screen by the user*s 2260 
data stream, the operator must then key an SMI character somewhere on 
the screen. Failure to do so results in no data being transmitted to 
the application program. 

After the data has been read in, CICS/VS 2260 compatibility transmits 
a single blank character to overwrite the SMI character* 

Note: Multiple SMI characters are not allowed on the same screen and 
will result in the error message: "DFH1031 ERROR IN PROCEDURE, CLEAR AND 
REENTER 11 . 


* 

$ 

$ or 
6 


NEW LINE SYMBOL (NL 1 


For CICS/VS 2260 compatibility, the new line (NL) function is replaced 
by a field mark character followed by the NL key. Any incoming field 
mark characters are treated as 2260 NL characters, and the remainder of 
the line is discarded. 

Including the NL symbol in the 2260 output data stream causes the 
substitution of a 3270 field mark character; the output continues at the 
beginning of the next line. (The 3270 field mark character displays as 
a semicolon.) 
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LINE ADDRESSING 


For a 3270 operating under CICS/VS compatibility, any reguests for write 
at line address are honored. CICS/VS 2260 compatibility converts the 
line address to the equivalent 3270 buffer address before transmitting 
the data stream to the screen. 


2848 LOCK FEATURE 


The optional lock feature available on the 2848 Display Control Models 
21 and 22 is supported by CICS/VS 2260 compatibility. Any read/lock 
request is honored by CICS/VS 2260 compatibility oy leaving the 3270 
keyboard inhibited. The keyboard is only reset if the transaction 
changes or if a WHITE macro instruction is issued by the application 
program. 


2845/2848 TAB FE ATURE 


The optional tab feature available on the 2845/2848 Display Control is 
supported by CICS/VS 2260 compatibility. Any tab character (colon) 
found in the output data stream is replaced by an attribute byte. This 
attribute byte is converted back to a 2260 tab character on a read 
operation. 

Because the tab feature uses an attribute byte, the terminal operator 
cannot key a tab character from the keyboard. The tab does not display 
on the screen, but is present in the user»s input data stream. 

For proper operation, transactions using the tab technigue are 
required to operate in FULLBUF mode. A tab character should not be 
inserted as the last character of a line. 

Because the tab feature uses an attribute byte, the cursor stops at 
the beginning of each line before stopping at the authorized attribute 
position, except in the case of 480/480 FULLBOF conversion. The cursor 
only stops at the authorized attribute position and the last position in 
the buffer. 


INITIATING TRANSACTIONS 


The terminal operator can initiate either 2260 compatibility or 3270 
native mode transactions by entering the appropriate CICS/VS transaction 
code. While in compatibility mode, any start of message indicator (SMI) 
character in the input data stream is recognized by CICS/VS; the 
succeeding four characters are interpreted as a CICS/VS transaction 
code. The transaction code must be contiguous and may not span two 
fields. 

CICS/VS then initiates the specified transaction. If the specified 
transaction is a 2260 compatibility transaction, CICS/VS automatically 
formats the 3270 screen. 

To allow easy transition between 2260 compatibility and 3270 native 
mode transactions, some conventions should be followed. Three 
acceptable methods of transition between transactions are: 
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1. Clear the screen; then enter the transaction code and any data to 
be presented to the transaction. 

In this case, the operator must enter the transaction code at the 
first position of the screen. The transaction code may be preceded 
by the SMI character, in which case the next four characters are 
interpreted as the transaction code. A transaction code may not 
contain an SMI character. 

2. For a terminal in compatibility mode, enter the SMI character, the 
transaction code, and data. If the transaction to be initiated is 
a compatibility transaction, all data from the SMI character to the 
cursor position is treated as a 2260 compatibility data stream and 
is mapped into 2260 format. For a native mode transaction, the 
data stream is identical with the data stream from an unformatted 
screen buffer. 

3. For a terminal in native mode with a formatted screen, the SMI 
character and transaction code must be the first data characters in 
the data stream. If the transaction code calls for a compatibility 
transaction, the screen is formatted for 2260 compatibility but no 
data is presented to the transaction. 
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Chapter 5.6. IBM 3735 Programmable Buffered Terminal 


This chapter provides a summary of the specific options which must be 
included in the CICS/VS system generation and table preparation macro 
instructions to provide support for the IBDl 3735 Programmable Buffered 
Terminal in a switched line network. The 3735 inquiry mode feature is 
also discussed. 


SYSTEM GENERA TION 

BTAMDEV=3735D and ANSWRBK=EXIDVER must be included in the DFHSG 
PROGRAM=TCP macro instruction during system generation. 


TERMINAL CONTROL TABLE PREPARATION 


FEATURE=AUTOANSR must ne specified in the DFHTCT TYPE=LINK macro 
instruction for all terminals on switched—line networks. To support the 
3735 Programmable Buffered Terminal, the following must also be 
specified: 

• DFHTCT TYPE=LINE,ANSWRBK=EXIDVER. 

• BTAM DFTRMLST macro instruction of the form SftLST,AN• The user 
portion of each 3735 DFTRMLST entry must point to the corresponding 
TCTTE. 

• DFHTCT TYPE=TERMINAL,TRMTYPE=3735. 

If FEATURE=AUTOCALL is specified in the DFHTCT TYPE-LINE macro 
instruction, the following must also be specified: 

• BTAM DFTRMLST macro instruction of the form SWLST,AD. 

• DFHTCT TYPE=TERMINAL,TRMADDR=parameter. 

The TRANSID operand is required for batch input in the form 
TRANSID=xxxx where xxxx is the transaction identification of the user- 
written batch processor. 


INQUIRY MODE 


CICS/VS deletes the inquiry header on input and inserts it on output. 
Therefore, inquiry applications require that: 

• A single output record is transmitted. 

• The output block does not exceed 233 bytes (plus a three—byte 
inguiry header). 

• The output data stream does not contain characters which are 
invalid for a 3735 (see the 3735 Programmer^ Guide ) . 
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If multiple inquiries are required in a single connection on a 
switched line, the user must make provision in his DFHTEP program to 
keep the line open* To accomplish this, the user may check for the 
IOERROR — TIMEOUT condition, a WRITE TR or READ TQ instruction, and th 
contents of TCTTEMCI for the value TCTTEMIQ, which is a hexadecimal 
blank character (X , 40 1 )* 
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Chapter 5.7. IBM 3740 Data Entry System 


This chapter contains information on the macros and operands which must 
be specified during the CICS/VS system generation and table preparation 
process to provide support for the IBM 3740 Data Entry System in a 
switched line network. The 3740 expanded ID verification feature is 
also discussed. 


S YSTEM GENERATION 

BTAMDEV=3740D must be included in the DFHSG PROGRAM=TCP macro 
instruction during system generation. 

| SIGN—ON TABLE PREPARATION 

I 

| For each operator identification card that is used to sign-on via the 
| 3741, the following parameters must be specified in DFHSNT TYPE=ENTRY: 

| • OPIDENT=ccc 

| • OPNAME=dd.. .d 

| • NAMFORM=DEC 


TERMINAL CONTROL TABLE PREPARATION 


FEATURE=AUTOANSR must be specified in the DFHTCT TYPE=LINE macro 
instruction for all terminals on switched—line networks. To support the 
3740 Data Entry System, the following must be specified: 

• BTAM DFTRMLST macro instruction of the form SWLST,AN. The user 
portion of each 3740 DFTRMLST entry must point to the corresponding 
TCTTE. 

• DFHTCT TYPE=TERMINAL,TRMTYPE=3740. 

If FEATURE=AUTOCALL is specified in the DFHTCT TYPE=LINE macro 
instruction, the following must also be specified: 

• BTAM DFTRMLST macro instruction of the form SWLST,AD. 

• DFHTCT TYP£=TBRMINAL,TRMADDR=parameter. 
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ID VERIFICATION 


If the 3740 does not have the expanded ID verification feature 
(specified in the ANSWRBK=BXIDVER operand of DFHTCT TIPE=LINE macro) , 
the first record (block) from the 3740 must; contain only the terminal 
identification; any other data in the first block will be disregarded 
Data must begin in byte 1 of the second block. 
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Chapter 5.8. IBM 3600 Finance Communication 
System (BSC) 


This chapter contains information on the CXCS/VS system generation and 
table preparation options which must he specified to provide support for 
the IBM 3600 Finance Communication System in a BSC network. The 3600 
buffer depletion feature is also described. 


SYSTEM GENERA TION 

BTAMDEV=3600 must be specified in DFHSG PROGRAM=TCP to generate 3600 BSC 
support. Other terminal control program parameters apply as follows: 

• FEATURE=TRANSPARENCY must be specified if CICS/VS and 3601 
application programs are to communicate in transparent mode. 

• BSCODE=EBCDIC is reguired for 3600 BSC support* 

• FEATURE=AUTOPOLL is required* 

• WRAPLST=YES should only be specified if the wrap list feature is to 
be included in CICS/VS. 


TERMINAL CONTROL TABLE PREPARATION 


The following parameters must be specified in DFHTCT TYPE=SDSCI for 3600 
BSC devices: 

• DEVICE=3600 if all terminals in the line group are 3600s or 
DEVICE=BSCMDMPT for mixed binary synchronous multipoint devices 
present in the line group. 

• BSCODS=EBCDIC. 

| In addition, the following specifications are reguired for VSB: 

• RETRY=6 to correspond to the 3600 binary synchronous access method 
(BAM)* 

• CU=2701 or 2702. 

• CONFIG=MPT and SWITCHING, because the 3600 runs as a non—switched 
multipoint tributary only. 

• TERMTST=NO, because BAM does not use the terminal test facility* 

• FEATURE=BSC. 

The poll list generated by the DFTRMLST macro must conform to the 
general poll requirements described for BAM in the IBM 3600 Finance 
Communication System Customer Feature Description for BSC3 Communication 
manual. CICS/VS support requires that a one character component address 
be specified in the 3601 CPGEN as the poll address. If necessary, the 
3600 entries must be padded with leading SYN characters if the line to 
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which the 3600 devices are attached also contains other device types, 
because the poll list entries must all be of the same length. 

The following parameters must be specified in the DFHTCT TYPE=LINE 
macro instruction: 

• TRMTYPE=3600. If a remote 3270 and a 3600 BSC device are both on 
one line, TRMTYPE must specify the remote 3270. 

• GENPOLL=YES• This is the default when TRMTYPE=3600, 3270, or 2980. 

» BSCODE=EBCDIC. This is the default* 

• INAREAL must accommodate the maximum input length, including data 
link control characters, from any device on the line. If a remote 
3270 is attached to the line, the length must not be less than 254. 
For 3600 control units sending unblocked data, the length must not 
be less than the largest message segment written to the host ny any 
single work station. For 3600 control units sending blocked data, 
the length must accommodate the maximum allowable transmission, as 
specified in the 3600 CPGEN. 

The following parameters relate to the DFHTCT TYPE=TERMINAL macro 
instruction: 

• TRMTYPE=3600 indicates a 3600 BSC device when the SDSCI and LINE 

| macros have also been specified thus. Otherwise, ACF/VTAM 3600 

support will ce generated. 

• FEATURE=TRANSPARENCY must be specified if the CICS/VS and 3601 
application programs issue transparent writes. 

If BUFFER=0 is specified or defaulted, CICS/VS sends output to the 
3601 in one transmission without segmenting it. Thus, both the 3601 
host input buffers and the receiving work station»s host input segment 
must be large enough to accommodate any CICS/VS application program or 
system message which can be sent to the work station. 

BMS parameters must not be specified because BMS is not supported for 
3600 BSC devices. 


BUFFER DEPLETION 


Buffer depletion occurs when the CICS/VS terminal control program 
attempts to send a message segment to a 3600 controller and receives an 
indication that the 3600 has no buffers currently available to receive 
data from the host. Each data transmission from CICS/VS occupies a 3600 
controller buffer until a work station reads the data into its work 
area. Thus, Duffer depletion may occur when 3600 work stations are not 
reading data sent by the host. If it detects a buffer depletion 
condition, the CICS/VS terminal control program waits 1.5 seconds and 
then retransmits the segment. This sequence is repeated until the 3601 
has a buffer available to receive the segment, or until some other error 
occurs. 
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Part 6. Modifying CICS/VS 




Chapter 6.1 


This part of the manual describes how the system programmer may apply 
user-written enhancements or variations, such as user exit routines or 
initialization overlays, which may be added to CICS/VS code, or, as in 
the case of the DFHTC CTYPE macro instructions, which may alter the 
status of part of the CICS/VS code. 

The information is presented in the following manner: 

6 . 2 . 

User Exits for CICS/VS Management Programs — which descrioes 
| the new CICS/VS user exit interface and the existing method of 

incorporating user—written exit routines into CICS/VS 
management programs. 

6.3. 

User Exits for Asynchronous Transaction Processing — which 
describes the user exits that may be coded when data is 
transferred using the CUTE and CEDE processors during 
asynchronous transaction processing. 

6.4. 

System Initialization Overlays — which describes the user- 
written overlays which may be added to the system 
initialization program. 

6.5. 

Modifying The Terminal Control Table — which provides 
information on the DFHTC CTYPE=CHBCK, COMMAND, LOCATE, and 
STATUS macro instructions that the system programmer may use to 
modify the status of the terminal control table. 

| 6.6 

| CICS/VS External Security Interface - which provides 

| information on modules DFHXSP, DFHXSC, and DFHACBE should the 

| user wish to create his own versions of them. 
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Chapter 6.2. User Exits for CICS/VS Manag e m e nt 
Programs 


| CICS/VS provides two methods by which user—written code can be executed 
| at selected points in CICS/VS management programs* These points are 
| known as exits. The method provided, for the first time, in CICS/VS 
| Version 1, Release 5 is the user exit interface, and is described below. 
| The existing method of incorporating user—written source code into a 
j number of CICS/VS management programs is unchanged and is discussed 
| later in this chapter. 


THE USER EXIT INTERFACE 


The user exit interface is provided by specifying the EXITS=YES operand 
in DFHSIT or by using the EXITS=YES override parameter. The interface 
has the following characteristics: 

1* The interface supports all existing exits in CICS/VS management 
programs except the exits in the transaction backout program. In 
addition, new exits in the journal control program and the 
intersystem communication program are supported. 

2. The user—written code for an exit is a separate assembler—language 
program. Such a program is called an exit program. 

3. The exit program would normally be link—edited by the user into the 
core—image library (VSE) or load library (OS/VS) , with an entry in 
the processing program table (PPT). 

4. Two or more exit programs can be used at a single exit, or 
conversely, a single exit program can be used at two or more exits* 

5. Exit activity is controlled dynamically by SNA3LE and DISABLE 
commands in a command—level application program (COBOL, PL/I, or 
assembler) or via the command interpreter. 

6. Enable/disable activity is not backed out by the dynamic 
transaction oackout program if the application program terminates 
abnormally. 

7. Enable/disable activity is not included in system-activity 
keypointing or warm keypointing. Thus, exit program status is not 
restored by CICS/VS during an emergency restart or warm start. 

8. When the CICS/VS system is being used in several regions, exit 
activity is independent for each region even if the management 
module is shared. Therefore, exit programs must be enabled in each 
region in which they are to be used. 

Both the old and the new facilities can be used in the same system. 
This allows users to migrate to the new facility gradually. 

It is possible to use both facilities at the same exit. Code 
generated for the new facility will immediately precede code generated 
for the old facility. 
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CHANGING TO TSfi USER EXIT INTERFACE 


The new user exit interface offers the following advantages over the old 
facility: 

• There is no need to reassemble CICS/VS management modules to 
include exit code. 

• The user has dynamic control over exit activity. 

• It provides improved reliability because the exit code is separate 
from the CICS/VS management modules. 

Thus, users of the old facility are recommended to migrate to the new 
facility. This can be achieved by: 

1. Modifying the exit routines to conform to the different base- 
addressing, register—saving, and return-code conventions described 
in the section "Exit Programs 11 , below. 

2. Including definitions for any symbols referenced in the exit 
routine that previously depended on definitions in the management 
module. 

3. Removing the user exit operands from the DFHSG macros. 


EXI T PROGRAMS 


The following general conventions apply to programs executed at exits in 
CICS/VS management modules. Information specific to each exit is given 
in Figure 6.2—1 later in this chapter. 

1. The program must be written in assembler language. 

2. Requests for CICS/VS services must not be used except at exits in 
the dynamic transaction backout program (DFHDBP) • 

3. The following general register values can be assumed on entry to an 
exit program: 

— Register 1 = parameter—list address (see item 6 below). 

- Register 13 = address of standard register save area for use by 

the exit program. 

— Register 14 = return address. 

— Register 15 = entry address of exit program. 

In addition, registers 2 through 11 may be used by the 
management module to pass arguments to the exit program, 
depending on the exit (see Figure 6.2—1). 

4. The exit program should save and restore any registers that it 
modifies, using the save area addressed by register 13. 
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5. For some exits, the exit program can control, by means of a return- 
code in register 15, the actions subsequently performed by the 
management module. If an invalid return—code is specified, or if 
two exit programs specify conflicting return—codes at the same 
exit, CICS/VS uses a default return—code established for the exit. 
The return code currently established for an exit is passed as a 
parameter to the exit program. This may be needed if two or more 
exit programs are used at one exit. 

6. When enabling an exit program, the system programmer can request 
that CICS/VS is to provide a global work area for use by the exit 
program. An exit program can have its own global work area, or two 
or more exit programs can share a work area. The address and 
length of the work area are passed as parameters to the exit 
programs that use it. A work area is freed when all exit programs 
that use it are disabled. 

7. A macro, DFHUEXIT TYPE=EP, is provided for use in exit programs. 

It generates: 

a. A DSECT for the parameter list passed to the exit program, as 
follows: 


DFHUEPAR 

DSECT 





UEPEXN 

DS 

A 

ADDRESS 

OF 

EXIT NUMBER 

UEPGAA 

DS 

A 

ADDRESS 

OF 

GLOBAL AREA 

♦ 



(ZERO : 

= NC 

) WORK AREA) 

UEPGAL 

DS 

A 

ADDRESS 

OF 

GLOBAL AREA LENGTH 

UEPCRCA 

DS 

A 

ADDRESS 

OF 

CURRENT RETURN-CODE 

UEPTCA 

DS 

A 

ADDRESS 

OF 

TCA 

UEPCSA 

DS 

A 

ADDRESS 

OF 

CSA 

USPEPSA 

DS 

A 

ADDRESS 

OF 

REGISTER SAVE AREA FOR 

♦ 



USE BY 

EXIT PROGRAM 

UEPHMSA 

DS 

A 

ADDRESS 

OF 

SAVE AREA USED FOR HOST 

* 



MODULE 

•S REGISTERS 


b. An EQU—list that equates the exit identifiers (exitids) used to 
identify exits externally to the exit—numbers used internally 
by CICS/VS to identify the exits* The exitids will not be 
changed in any future releases of CICS/VS, but the exit—numbers 
may; therefore, it is recommended that an exitid is always used 
in an exit program to refer to an exit. 

8. Neither source nor object compatibility of CICS/VS management 

modules is guaranteed for future releases of CICS/VS. Any changes 
that effect exit programs will be documented in the appropriate 
manual• 


ENABLING AN EXIT PROGRAM 

An exit program is enabled in three stages, as follows: 

• Enable — to load the exit program or specify its entry address, and 
obtain a work area for use by the exit program, if requested. 

• Activate — to associate the exit program with an exit. 

• Start — to make the exit program available for execution* 
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| These three stages can he performed in a single ENABLE command (see 
| below) or can be split across two or more commands. In an application 
| program, only one exit can be specified in a single ENABLE command; 

| therefore, if an exit program is to be activated for two or more exits, 

| the START option allows execution of the exit program to be suppressed 
| until all the ENABLE commands are completed. 

| The commands listed in this chapter are intended to be used by the 
| system programmer only, and not by the application programmer. They are 
| not supported in the RPG language. 

| The general rules about the use of commands in CICS/VS application 
| programs are given in the CICS/VS Application Programmer^ Reference 
| Manual (Command Level) . 

I Mote : The enabling and disabling of an exit program has no effect on 
| the enable or disable status of the PPT entry for the program. 


ENABLE Command 

EXEC CICS ENABLE 

PROGRAM (name) 

[EXIT (name) ] 

[START ] 

[ENTRY (pointer-value) ] 

[GALENGTH (data—value) | GAPROGRAM (name) ] 


EXEC CICS ENABLE 

specifies that all or part of the enable-activate-start 
seguence is to be performed for an exit program. 


PROGRAM (name) 

specifies the name of the exit program. If the ENTRY operand 
is specified, the name can be any character—string up to 8— 
bytes. Otherwise, it must be the name of a program in the PPT. 


EXIT (name) 

specifies the exitid of the exit for which the exit program is 
to be activated (see M CICS/VS Exits 11 later in this chapter) . 
CICS/VS does not check that the management program containing 
this exit is present in the CICS/VS system. If the management 
program is not present, the ENABLE command could complete 
normally but of course the exit will never be used. 


START 

specifies that, after the exit program has been activated for 
the specified exit (if any), the exit program is to be started. 
Where several exits are associated with an exit program, 
omission of this operand allows exit program execution to be 
suppressed until sufficient exits have been associated with the 
exit program for it to execute correctly. 
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ENTRY (pointer—value) 

specifies the entry address of the exit program. If this 
operand is specified, CICS/VS assumes that the exit program is 
already loaded and so will not attempt to load it. Also it 
will not attempt to delete it when the exit program is 
disabled. If this operand is not specified, the exit program 
is loaded by CICS/VS, the entry address returned from the load 
is used, and CICS/VS will delete the exit program when it is 
disabled* 

Note : To use the ENTRY operand, the user must know the 
entry address of the exit program. The LOAD command returns 
the start address, therefore the entry address can be found 
easily if it is the same as the start address. 


GALENGTH(data-value) 

specifies the length, in bytes, of the global work area that is 
to be provided by CICS/VS for this exit program. If a data 
variable is specified, it must represent a halfword binary data 
item. Valid lengths are 1 through 32767. The work area will 
be initialized to binary zeros. 


GAPROGRAM(name) 

specifies the name of a currently enabled exit program whose 
global work area is also to be used by the exit program being 
enabled. The exit program specified must own the work area 
(that is, GALENGTH must have been specified when the exit 
program was enabled). If a work area is shared by two or more 
exit programs, it is not released until all these exit programs 
are disabled. However, after the owning exit program is 
disabled, no new exit program can share the work area. 

GALENGTH and GAPROGRAM are mutually exclusive. If both operands 
are omitted, no work area is provided* 

On the second and subsequent ENABLE commands for a particular exit 
program, ENTRY, GAPROGRAM, and GALENGTH must not be specified and either 
EXIT or START, or both, must be specified* 

Examples : The enable-activate-start sequence for an exit program can be 

done in a single ENABLE command, or in two or more ENABLE commands, as 
follows: 


In one command: 

ENABLE PROGRAM (*EP1 1 ) EXIT (»XFCOUT 1 ) START 

This command loads exit program EP1, activates it for exit XFCOUT, and 
starts the exit program. No work area is obtained* 


ENABLE PROGRAM (•EP2 1 ) EXIT (•XKCDISP 1 ) START ENTRY (EADDR) 

GALENGTH (500) 

This command assumes that exit program EP2 is already loaded, with its 
entry address in EADDR. It activates EP2 for exit XKCDISP and starts 
the exit program. A work area of 500 bytes is obtained. 
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| In two or more commands: 

| ENABLE PROGRAM ( , EP3 I ) EXIT (•XTDOUT •) GAPROGRAM 1 EP2 1 ) 

| ENABLE PROGRAM (•EPS') EXIT (*XTDIN•) 

| ENABLE PROGRAM (•EP3 1 ) EXIT ( •XTDREQ •) START 

I 

| The first command loads exit program EP3 and activates it for exit 
| XTDOUT; EP3 will be able to use the work area obtained for EP2• The 
| second command activates EP3 for exit XTDIN. The third command 
| activates EP3 for exit XTDREQ and starts the exit program. 


| DISABLING AN EXIT PROGRAM 

I 

| An exit program is disanled in three stages, as follows: 

| • Stop — to make the exit program unavailable for execution. 

| • Deactivate — to dissociate the exit program from an exit. 

| • Disable — to delete the exit program if appropriate and release a 

| work area if appropriate. 

I 

| As for ENABLE, these three stages can be performed in a single DISABLE 
| command, or can be split across two or more commands. 


| D ISABLE Comman d 

| EXEC CICS DISABLE 

| PROGRAM (name) 

| [EXIT (name) | EXITALL] 

| [STOP ] 

| EXEC CICS DISABLE 

| specifies that all or part of the stop—deactivate—disable 

| sequence is to be performed for an exit program. 


| PROGRAM (name) 

| specifies the name of the exit program. 


| EXIT (name) 

| specifies the exitid of an exit for which the exit program is 

| to be deactivated (see ”CICS/VS Exits” later in this chapter) . 

| The exit program will not be disabled. 


| EXITALL 

| specifies that the exit program is to be deactivated for all 
I exits for which it is active. The exit program will then be 
| disabled. EXITALL implies STOP. 


556 


CICS/VS System Programmers Reference Manual 



STOP 


specifies that the exit program is to be stopped before any 
deactivations are done. Where several exits are associated 
with an exit program, this operand allows exit program 
execution to be suppressed while sufficient exits are 
associated with the exit program for it to execute correctly. 

At least one of the operands EXIT, EXITALL, and STOP must be specified. 
EXIT and EXITALL are mutually exclusive; if both are omitted, no 
deactivations are performed. 

Examples : The stop—deactivate—disable sequence will usually be 

performed in a single DISABLE command. However, it is possible to use 
the command to stop or deactivate an exit program without disabling it. 

DISABLE PROGRAM( , EP3 i ) EXITALL 

This command stops exit program EP3, deactivates all its exits, and then 
deletes the exit program. 


DISABLE PROGRAM ( , EP2 > ) STOP 

This command simply stops exit program EP2• It can be restarted later 
by issuing ENABLE PROGRAM (•EP2*) START. 


DISABLE PROGRAM(»BP3 # ) EXIT (»XTDREQ•) 

This command deactivates exit program EP3 for exit XTDREQ. Any other 
exits associated with EP3 will be unaffected. Subsequently, to fully 
disable EP3, the user must issue: 

DISABLE PROGRAM (*EP3 t ) EXITALL 


ACCESSING A WORK AREA 


Application programs can obtain the address and length of the global 
work area that is owned or shared by a specific exit program by means of 
the EXTRACT EXIT command. 


| E XTRACT EXIT Command 

| EXEC CICS EXTRACT 

| EXIT 

| PROGRAM (name) 

I GASET (pointer—ref) 

| GALENGTH (data-area) 

| EXEC CICS EXTRACT 

i specifies that information is to be extracted from a CICS/VS 

| control block. 


| EXIT 

| specifies the type of control block. 
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PROGRAM (name) 

specifies the name of an exit program. The address and length 
of this exit program^ global work area is to be extracted from 
the control block. The exit program can either own or share 
the work area. 


GASET (pointer-ref) 

specifies the variable that is to be set to the address of the 
work area used by the exit program. 


GALENGTH (data-area) 

specifies the variable that is to be set to the length of the 
work area used by the exit program. It must be a halfword 
binary data item. 


E xample ; 

EXTRACT EXIT PROGRAM ( *EP1 • ) GASET (WORKA) GALENGTH (NORKL) 

This command puts the address of the work area used by exit program EP1 
in the pointer referenced by WORKA, and puts the length of the work area 
in the data item referenced by WORKL. 


EXCEPTIONAL CONDITIONS 


All errors in the ENABLE, DISABLE, and EXTRACT EXIT commands are grouped 
under the single INVEXITREQ exceptional condition. The exact cause of 
the error can oe determined by examining the second and third bytes of 
EIBRCODE, which can have the following hexadecimal values: 
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EIBRCODE 
bytes 2—3 

Command 


seanina 

X'8000* 

ENABLE 


Program specified in PROGRAM 
is not in PPT, or is not in 
core—isage/load library, or 
its PPT entry has been disabled. 

4000 

ENABLE 


Ezitid is invalid. 


DISABLE 


Exitid is invalid. 

2000 

ENABLE 


Program specified in PROGRAM 
is already enabled. 

1000 

ENABLE 


Program specified in PROGRAM 
is already active for the 
exitid specified in EXIT. 

0800 

ENABLE 


Program specified in GAPROGRAH 
is not enabled. 

0400 

ENABLE 


Program specified in GAPROGRAM 
does not own a work area. 


EXTRACT 

EXIT 

Program has no work area. 

0200 

DISABLE 


Program is not enabled. 


EXTRACT 

EXIT 

Program is not enabled. 

0100 

DISABLE 


Program has not been activated 
for exitid specified in EXIT. 

0080 

DISABLE 


Program is currently invoked 
by another task (see note). 

0040 

all three 

User exit interface was not 
initialized. 

The default 

system action 

for the INVEXITREQ exceptional condition is to 


terminate the transaction with abend code AEYV• 

N ote : The INVEXITREQ condition with X^QSO* in bytes 2 and 3 can occur 

only if a task, switch has occurred in the exit program due to a request 
for a CICS/VS service. This is supported only for exits in DFHDBP. The 
normal action for this condition is to retry the DISABLE request. 
However, if such an exit program terminates abnormally, then its use 
count will remain greater than zero and it cannot be disabled or 
deactivated, but it can be stopped. 


| TRACE TABLE ENTRIES 

I 

| An entry in the CICS/VS trace table can be made immediately before and 
| after the execution of an exit program. Generation of these entries can 
| be started and stopped by specifying the UK option on the TRACE ON and 
| TRACE OFF commands respectively. The UE option can also be specified in 
| the STYPE operand of the DFHTR macro in macro-level application 
| programs. 
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| CICS/VS EXITS 

I 

| Figure 6.2—1 lists the standard exits available in CICS/VS management 
| modules, and the information that is specific to each exit. For exits 
| where no valid return-code is listed, the management module will always 
I continue in the same way irrespective of the value in register 15. 

I Note : If both new and old user exit facilities are being used at the 
I same exit, at exits where it is possible to specify a return-code other 
| than zero, execution of the old user exit facility will only be done if 
| a return code of zero is returned from the new facility. 
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MODULE 

DFHDBP 


DFHFCP 


DFHICP 

DFHISP 

DFHJCP 

Figure 


EXITID 

LOCATION 

PARAMETERS PASSED 

VALID 

R^ireir-CODEB 

XDBINIT 

On entry 
to DPHDBP 

none 

0-continue with 
backout 

4=suppress DL/I 
backout 
8=suppress all 
backout 

XDBIN 

After each 
log record 
received 

B3—>dynamic log 
record 

(except DL/I) 

0=continue pro¬ 
cessing record 
4=ignore record 

XDBFBRR 

When error 
returned 
from FCP 

B3->dynamic log 
record 

B6—>file work 

area, if any 

0-accept error 
and continue 
4=ignore error 
and continue 
8=retry 

XDBDBBB 

When DL/I 

error 

found 

B3—>dynamic log 
record 

0=suppress further 
DL/I backout 
4=ignore error 
and continue 

XFCREQ 

Before 

entry 

analysis 

none 


XFCIN 

Before 

input 

event 

B9—>FCT entry 


XFCOUT 

Before 

output 

event 

B9—>FCT entry 

BIO—>file work area 

XFCINC 

After 

input 

event 

B9—>FCT entry 

B11—>file I/O area 

(BDAH and ISAM) 
or VSAB work area 

XICRBQ 

Before 

request 

analysis 

none 


XICEXP 

After time 
interval 
has expired 

B8—>ICE that has 
just expired 


XISLCLQ 




XJCWR 

After jour¬ 
nal record 
built in 
buffer 

B7->journal record 
just built 

B11—>JCT entry 


6^2-1 (Part 1 of 3) . 

Standard Exits Available in CICS/VS 


Management Modules 
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MODULE 

EXITID 

LOCATION 

PARAMETERS PASSED 
IS REGISTERS 2-11 

VALID 

RETURN-CODES 

DFHKCP 

XKCREQ 

Before 

request 

analysis 

none 



XKCDISP 

Before 

dispatch 

R3—>DCA 



Note: 

For XKCDISP, R12->TCA 

being dispatched 

DFHPCP 

XPCLOAD 

After XCTL 
or LINK 

R8—>PPT entry 

DFHSCP 

XSCREQ 

Before 

none 



request 

analysis 



Note: The user exit XSCREQ is not executed when DFHSCP is invoked to 


obtain 

more LIFO 

storage. 



DFHTCP 

XTCIN 

After 

input 

event 

R2-> TCTTE 
R4—>TIOA 



XTCOUT 

Before 

output 

event 

R2—>TCTTE 
R4—>TIOA 



XTCATT 

Before 

task 

attach 

R2->TCTTE 
R4—>TIOA 



XTCRDAT 

After 

2741 read 
attention 

R2->TCTTE 
R4—>TIOA 



XTCTIN 

After 

TCAM 

input 

event 

R2—> TCTTE 
R4—>TIOA 

0=CICS/VS will 
format TCAM 
header 

4=CICS/VS will not 
format TCAN 
header 


XTCTOUT 

Before 

TCAM 

output 

event 

R2—>TCTTE 
R4—>TIOA 

0=CICS/VS will not 
not format TCAM 
header 

4=CICS/VS will 
format TCAM 
header 

Note: 

either 

For all exits in DFHTCP, the address of the TCTLB can be obtained 
from the register 1 slot in the management module's register save 


area (the address of which is passed as a parameter to the exit program) 
or from the 4-byte field TCTTELEA in the TCTTE. 


Figure 6.2—1 (Part 2 of 3). Standard Exits Available in CICS/VS 
Management Modules 
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MODULE 

SXXXXD 

T.Qr&TTDM 

DFHTDP 

XTDREQ 

3efore 

request 

analysis 


XTDIN 

After 

input 

event 


XTDOUT 

Before 

output 

event 

DPHTSP 

XTSREQ 

Before 

reguest 

analysis 


XTSIN 

After input 
event 


XTSOUT 

Before out¬ 
put event 

DFHZCB 

X ZCIN 

After input 
event 


PARAMETERS PASSED V AL ID 
IN RESISTERS 2-11 BETPBH—CODES 

R3—>DCT entry 


R3—>DCT entry 


B3—>DCT entry 


R4—>TSIOA (after SAA), 
if any 


R4—>TSIOA (after SAA) 
R8—>TSGID 

B4—>TSIOA (after SAA) 
R5->record prefix 
R8—>first TSGID 

R8—>TIOA 
RIO—>TCTTE 


XZCOUT 


Before out— B8—>TIOA 
put event BIO—>TCTTE 


DF3ZCP XZCATT 


Before task R8->TIOA 
attach B10->TCTTE 


Figure 6.2—1 (Part 3 of 3). Standard Exits Available in CICS/VS 
Management Modules 


THE EXISTING USER EXIT FACILITY 


This section describes the user exit facility that existed prior to 
CICS/VS release 1.5, and is still supported by CICS/VS release 1.5. 

To include a user—written exit routine in a particular CICS/VS 
management program, the user must place the source code in a CICS/VS 
source library member (OS/VS) or book (VSE) that has the naming 
convention: 

DFHxxEXT 

where "xx" is the two-character designation for the management program 
into which the user—written code is to be included. The acceptable two- 
character designations are: 
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KC (Task Control) 

SC (Storage Control) 

PC (Program Control) 

TC (Terminal Control) 

PC (Pile Control) 

IC (Interval Control) 

TD (Transient Data Control) 

TS (Temporary Storage Control) 

TB (Transaction Backout — see "Data Base Backout and Message 

Recovery 11 in Chapter 4.8.) 

DB (Dynamic Transaction Backout) 

| TZ (ACF/VTAM Terminal Control) 

The code provided by the user in a given member (book) may consist of 
more than one routine (function), depending upon the number of linkages 
provided in the particular CICS/VS management program. For example, 
file management provides linkage to user—written exit routines both 
before and after an input operation. Thus, user—supplied code in the 
member (book) DPHFCSXT might contain two routines, each identified by a 
unigue symbolic name. 

Linkage from the CICS/VS management program to the appropriate user- 
written exit routine is accomplished by one of the following methods: 

1. An assembler BAL instruction that uses the user-defined symbolic 
name as the "branch to" label and general register 14 as a return 
register. 

2. Register 14 is loaded with an address constant for the user defined 
symbolic name and a BALR 14,14 instruction is issued. 

Note : The user—written exit routines are located at the end of the 

management programs. The length of some programs is such that the exit 
routines are not addressable by the program*s base register(s) . This 
condition forces the use of method 2 above, and reguires the exit 
routine to establish its own addressability upon gaining control. 

Under method 1, at least some beginning part of the user exit routine 
is addressable by a management program base register. Another base 
register may be required for the rest of the exit routine. 

The symbolic name of the exit routine is specified in the appropriate 
operand when the management program is generated. For example, in 
response to the 

DFHSG PROGRAM=SCP, * 

XTYPREQ=ORANGE 

specification, user exit linkage in the form of an assembler language 
BAL 14,ORANGE 

instruction is generated in the appropriate place in the storage control 
program. In this example, source code similar to the following should 
have been provided by the user in the member DFHSCEXT: 
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ORANGE BS OH 


USER EXIT ENTRY 


User code 


BR 14 

On entry to a user exit routine, registers can be saved in the CSA 
register save area (CSAOSRSA). The CSA may be used for saving 
registers, provided no other routines or services for CICS/VS modules 
are called by the exits. The method has the advantage of producing 
"read-only" code. 

| The following example shows the use of OS/VS or VSE SAVE and RETURN 
macro instructions to save registers 5 through 9 and to use register 5 
as a base register. 


ORANGE DS OH 

SAVE (5,9) 

BALR 5,0 
USING *, 5 


USER EXIT ENTRY 
SAVE REGS 5,6,7,8,9 
IN CSAOSRSA 
USE REG 5 AS BASE REG 


RETURN (5,9) RESTORE REGS 5,6,7,8,9 

AND RETURN VIA REG 14 

| The exit routine should not issue any OS/VS or VSE macro 

instructions. This includes releasing control to another task: which 
might use this same (or another) exit routine. The user must take care, 
however, especially if the routine could lose control to another CICS/VS 
task. 

When creating the CICS/VS management program assembly jobs during 
system generation, a COPY DFHxxEXT statement is included immediately 
preceding the assembler END statement* In the above example, the 
following would be generated: 


COPY DFHCSADS 
COPY DFHTCADS 


COPY DFHSCBXT 
END 

When coding user exits for CICS/VS management programs, the user 
should adhere to the following conventions and guidelines: 

1. Because user exits are essentially "in line" with the management 
programs, the programmer should be familiar with the functions of 
the program to which the exit code is being added. 

2. Unless the original contents are restored before return to the 
CICS/VS management program, user—written exit routines must never 
alter the contents of registers that provide addressability to 
control blocks. 


Chapter 6.2. User Exits for CICS/VS Management Programs 


565 



3. User—written exit routines must never violate restrictions of the 
management programs. For example, an exit routine in storage 
control cannot issue a DFHSC GETMAI8 request. Exit routines 
should not issue requests for CICS/VS services* In particular, 
user exits must not invoke any CICS/VS functions that could cause 
the task to be put into a CICS/VS wait state. Certain CICS/VS 
management functions (for example, DFHZCP) rely on not being 
interrupted during the processing of an item. This restriction 
usually extends across a user exit. 

4. User—written exit routines must be coded in assembler language. 

5. Symbolic names (labels) used to define user exit entry points must 
not be duplicates of labels in the CICS/VS management program. 

6. Base register addressability for the user—written exit routine 
exists only to the extent of the base register (s) associated with 
the management program. The user exit must never alter the base 
register (s) of the management program. The user is responsible for 
saving registers and establishing addressability. 

7. Register contents differ depending on the management program and 
particular exit function. However, the contents of the following 
registers are always constant: 


Register 


Contents 


14 Return address 

13 CSA address 

12 TCA address 


Depending on the management program and functional user exit, certain 
general registers contain information that the user may find useful. 
Figure 6.2—2 lists the exits available with the old user exit facility 
and the contents of these registers. For the location of the exits, see 
the entry for the corresponding exitid in the table of exits (Figure 
6.2—1) for the new facility. 


| The return code mechanism is different from that for the new 
| facility, instead of putting the return—code in register 15, it is used 
directly as a displacement for a branch table, thus: 

B return-code (R14 ) 


| For exits in DFHDBP, the same return codes are used as in the new 
I facility (see Figure 6.2—1). For the TCAM exits in DFHTCP, the meanings 
j of the return codes are reversed, that is, B 0(R14) will bypass CICS/VS 
| formatting of the TCAM header. 
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MODULE 

EXITIP 

PARA METERS PASSED 


OLD 

NEW 

IN REGISTERS 

| DFHDBP 

XINIT 

XDBINIT 



X INPUT 

XDBINP 

DBRREG—>dynamic log record 
(except DL/I) 


XFEEROS 

XDBFERR 

DBRREG—>dynamic log record 

FWACBAR—>file work area, if any 


XDEREOR 

XDBDERS 

DBRREG—>dynamic log record 

DFHFCP 

XTYPREQ 

XFCREQ 

none 


XINPUT 

XFCIN 

PCTDSBAR—>FCT entry 


XOUTPUT 

XFCOUT 

FCTDSBAR—>FCT entry 

FWACBAR—>file work area 


XINPUTC 

XFCINC 

FCTDSBAR—>FCT entry 

FIOABAR—>file I/O area (BDAM and ISAS) 
or VSWABAR—>VSAM work area 

DFHICP 

XTYPREQ 

XICR EQ 

none 


XICEEXP 

XICEXP 

ICECBAR—>ICE that has just 
expired 

DFHKCP 

XTYPREQ 

XKCREQ 

none 


XDSPCHR 

XKCDISP 

DCACBAR—>DCA 


Note : For XDSPCHR, TCACBAR—>TCA being dispatched 

DFHPCP XFETCH XPCLOAD PPTCBAH->PPT entry 

DFHSCP XTTPEEQ XSCREQ none 


Figure 6.2—2 (Part 1 of 2). Module and Exit Information 
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DFHTCP 

XINPUT 

XTCIN 

TCTLEAR—>TCTLE 
TCTTEAR—>TCTTE 
TIOAB AR—>TIOA 


XOUTPUT 

XTCOUT 

TCTLEAR—>TCTLE 
TCTTEAR—>TCTTE 
TIOABAR—>TIO A 


XATTACH 

XTCATT 

TCTLEAR—>TCTLE 
TCTTEAR—>TCTTE 
TIOABAR—>TIOA 


XRDATT 

XTCRDAT 

TCTLEAR—>TCTLE 
TCTTEAR—>TCTTE 

TIOA3AR—>TIOA 


XTCMIN 

XTCTIN 

TCTLEAR—>TCTLE 
TCTTEA R—>TCTTE 
TIOABAR—>TIOA 


XTCMOUT 

XTCTOUT 

TCTLEAR—>TCTLE 
TCTTE AR—>TCTTE 
TIOABAR—>TIOA 

DFHTDP 

XTYPREQ 

XTDREQ 

DCTCBAR—>DCT entry 


XINPUT 

XTDIN 

DCTCBAR—>DCT entry 


XOUTPUT 

XTDOUT 

DCTCBAR—>DCT entry 


XTYPREQ XTSREQ TSDA->TSIOA (after SAA), if any 
XINPUT XTSIN TSWKREG—>TSIOA (after SAA) 

TSGID3AR—>TSGID 

XOUTPUT XTSOUT TSWKREG—>TSIOA (after SAA) 

TSCIR->record prefix 
TSGIDBAR—>first TSGID 

DFHZCB XINPUT XZCIN NIOA3AR->TIOA 

TCTTEAR—>TCTTE 

XOUTPUT XZCOUT NIOABAR—>T10A 

TCTTEAR—>TCTTE 

| DFHZCP XATTACH XZCATT NIOABAR—>T10A 

TCTTEAR—>TCTTE 

Figure 6*2-2 (Part 2 of 2). Module and Exit Information 


The following exits in DFHTBP are only available in the old facility 
because DFHTBP is run during CICS/VS initialization, before any exit 
programs can be enabled by the new facility* See chapter 4*8 for 
details of the parameters passed in the registers. 

MODULE EXIT1D LOCATION 

DFHTBP XINIT 1. On entry to DFHTBP 

2* After error found while 
opening a file 
3* Prior to termination 
of DFHTBP 

XINPUT After record has been read from 

restart data set 

XFERROR After error found during file 

backout 

XDERROR After error found during DL/I 

backout 


| DFHTSP 
I 
I 
I 


568 


CICS/VS System Programmer^ Reference Manual 



Chapter 6.3. 



Processing 


This chapter provides information on the CICS/VS CRDR (input) and CWTR 
(output) processors, which may be used to transfer data when the 
asynchronous transaction processing feature of CICS/VS is being used. 

If the asynchronous transaction processing facility is used, the 
CICS/VS-provid&d input processor (CRDR) and output processor (CWTR) are 
employed to transfer data to and from CICS/VS. The two programs 
accomplish the transfer of data without regard to its content. For 
example, terminal—dependent characters are neither inserted nor removed 
by CICS/VS. 

However, it may be desirable to perform some preprocessing or 
postprocessing on the terminal data. Such processing might be for 
purposes of: 

• Validity and limit checking 

• Removing or inserting device dependencies 

• Summarizing or formatting 

• Providing additional communication with CICS/VS 

These and other services can be accomplished through the use of the 
user exits provided by CRDR and CWTR. When receiving input to CICS/VS, 
CRDR makes each transmitted record available to a user—written exit 
routine immediately after it is received. On output, CWTR offers each 
record to a user-written exit routine immediately after it has been 
deblocked from its transient data input area (TDIA) and is about to be 
transmitted. All records, including delimiter records, are made 
available. 

The exit routine is invoked by specifying its program name suffix in 
the CRDR or CWTR initiating the message. For example: 

CRDR EXIT=MD,NAME=WICHITA 

causes CRDR to load the program named DFHXITMD (where DFHXIT is the 
standard exit routine base name and HD is the suffix) and pass each 
record to that routine while building a batch named WICHITA. 

Similarly, the statement: 

CWTR NAME=FINDLAY, TERMID = (TMLA,TMLB,TMLC) ,EXIT=DI 

causes CWTR to load the program DFHXITDI and pass each output record 
(associated with the output of batch FINDLAY) to the routine before it 
is transmitted to the terminal. 

One additional point should be noted concerning records given to the 
CWTR exit routine. Messages sent in response to a STATUS request are 
passed to the routine. For example: 

CWTR NAME=SUNYV ALE,STATUS,EXIT=CN 

causes the message concerning the status of a batch named SUNYVALE to be 
passed to DFHXITCN• This permits the user-written exit routine to 
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augment the status message. All CICS/VS service macro instructions may 
be used in the exit programs. 


CODING THE CEDE EXIT ROUTINE 


The input processor (CEDE) uses the following basic TCA work area 
definitions: 



COPY 

DFHTCADS 



TWAEEC 

DS 

A 

ADDRESS OF BECOED TO 

BE INSERTED 

TWAWA 

DS 

A 

ADDRESS OF USEE WOEK 

AREA 

TWAIND 

DS 

X 

INDICATORS 


TWAXTBTN 

EQU 

o 

00 

X 

EXIT PROGRAM RETURN 

INDICATOR 


DS 

3X 

RESERVED 



DS 

20F 

RESERVED 



These fields (plus any additional fields) should be defined by the 
user-written exit routine within the limits specified in the program 
control table (PCT) entry for the routine. Information is passed 
between CEDE and the exit routine by means of this TCA work area. 

Upon initial entry to the exit routine, TWAWA and the TWAXTBTN bit 
are zero. On all entries, TWAEEC is zero* All modification of the 
TWAXTBTN bit must be done by either the instruction 01 TWAIND,TWAXTBTN 
or the instruction NI TWAIND,255—TWAXTBTN. The user exit must not 
modify the bits in the TWAIND field used by CWTE. On all entries to the 
exit routine, register contents are as follows: 


Eeaister Contents 


15 

Exit routine 

14 

Exit routine 

13 

CSA address 

12 

TCA address 

8 

TIOA address 

7 

BCA address 


entry address 
return address 

of last message read 


The only registers that cannot be used in the routine are registers 
12 and 13. The other registers are saved before exiting and restored by 
CEDE upon return. The batch control area (BCA) is defined in the 
symbolic storage definition DFHBCADS. (See the appropriate CICS/VS Data 
Ar eas manual for a description of the batch control area.) 

The exit routine must be enterable at two points* The fir^t entry is 
for routine initialization and is made through an assembler BALE 14,15 
instruction. This is done only once so that turning on the TWAXTBTN bit 
does not cause a reentry to occur. The message in the TIOA is the CEDE 
transaction invoking message. 

All subsequent entries to the exit routine are made through an 
assembler BAL 14,4 (15) instruction. This entry is made after each 
message is read. 
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The exit routine entry coding flight appear as follows: 


DFHXITAB CSECT 

USING *,15 

B IN IT 

B MSGP 

DROP 15 

USING DFHXITAB,10 


INIT 


LR 10 ,15 


MSGP 


LR 10 , 15 


If the record just read is to be accepted without change or is to be 
altered but its length is not to be changed, the record can be processed 
in the TIOA and return made to CRDR through a BR 14 instruction. TWAREC 
and the TWAXTRTN bit should remain zero. 

If the length of the record just read is to be changed, the record 
can be processed in the TIOA by altering the TIOATDL field (if the 
changed record does not exceed the size of the TIOA)• TWAREC and the 
TWAXTRTN bit should be zero. If the record is to be lengthened such 
that it will not fit into the TIOA, the record must be built in a user- 
defined work area as a standard variable—length record (VLR). (The 
record in the TIOA is not a standard VLR because the value in TIOATDL is 
four less than a VLR count.) The address of the count field (LL##) is 

then put into TWAREC and control is returned to CRDR. 

When the exit routine once again gains control, TWAREC is zero and a 
new message is in the TIOA. A work area used to alter records may be 
defined in the TCA work area or acquired dynamically through a DFHSC 
GETMAIN request. If acquired dynamically, its address may be stored at 
TWAWA. 

To insert records into the input stream, each new record must be 
built in an exit routine work area, its address placed at TWAREC, the 
TWAXTRTN bit set on, and control returned to CRDR. The new record is 

inserted and control is returned to the exit routine with TWAREC set to 

zero and the TWAXTRTN bit unchanged. After all new records have been 
inserted in this manner, the TWAXTRTN bit must be set to zero and 
control returned to CRDR with TWAREC containing zero. The original 
message in the TIOA is placed into the input stream and a new message is 
read from the terminal. 

If the original message in the TIOA is to be deleted, control must be 
returned to CRDR with TWAREC containing the address of P'O*. 
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CODING THB CWTR EXIT ROUTINE 


The output processor (CWTR) uses the following basic TCA work area 
definitions: 



COPY 

DFHTCADS 

TWANXREC 

DS 

A 

TWAREC 

DS 

A 

TWAWA 

DS 

A 

TWAIND 

DS 

X 

TWAXTRTN 

EQU 

X • 80 1 


DS 

3X 


DS 

3 OF 

The se 

fields 

(plus any additional 


user—written exit routine within the limits specified in the PCT entry 
for the routine. Information is passed between CWTR and the exit 
routine by means of the TCA work area. 


Upon initial entry to the exit routine, TWAWA and the TWAXTRTN bit 
are zero. On all entries, TWARSC is zero, and TWANXREC points to the 
variable—length record to be transmitted to the output terminal. Any 
modification of the TWAXTRTN bit must be done on a bit level, because 
other bits in TWAIND are used by CWTR. 


The first four bytes of a variable—length record contain a two—byte 
length field and, occasionally, two bytes of control information. In 
the case of the record to be handled by CWTR, the first of these two 
control bytes (byte three of the record) contains the byte that would 
ordinarily be moved to TCTTEOS by the DFHTC macro instruction. The 
second control byte (byte four of the record) applies only to records 
that are destined for a 2260 Display Station (a 3270 operating in 
compatibility mode) or a 3270 Information Display System; this control 
byte corresponds to the TIOALAC or TIOACLCR field. If the destination 
terminal is a 3270 and the TIOACLCR field is not applicable, X # C3 # (the 
default value) must be moved into this control byte* 

If the length of an existing record is to be changed, the two control 
bytes probably are not affected and the information from the original 
record can be used. However, if a new record is built, one or both of 
these control bytes must be constructed* 

On all entries to the exit routine, register contents are: 


Register Contents 


15 

14 

13 

12 

7 


Exit routine entry address 
Exit routine return address 
CSA address 
TCA address 
3CA address 


The only registers that cannot be used in the routine are registers 
12 and 13. The other registers are saved before exiting and restored by 
CWTR upon return. 

The exit routine must be enterable at two points. The first entry is 
for routine initialization and is made through an assembler BALR 14,15 
instruction. This is done only once, so that turning on the TWAXTRTN 
bit does not cause a reentry to occur. TWANXREC does not point to a 
message when this entry point is used. 
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All subsequent entries to the exit routine are made through an 
assembler BAL 14,4(15) instruction. This entry is made after each 
message is denlocked and is about to be transmitted. 

The exit routine entry coding might appear as follows: 


DFHXITAB 

CSECT 



USING 

*,15 


B 

INIT 


B 

MSGP 


DROP 

15 


USING 

• 

DFHXITAB,10 

INIT 

• 

• 

LR 

• 

10,15 

MSGP 

• 

• 

LR 

10,15 


If the record about to be written is to be accepted without change or 
is to be altered but its length is not to be changed, the record can be 
processed in its current area. This area is pointed to by TWANXREC. 
Return to CWTR is made with a BR 14 instruction; TWAREC and the TWAXTRTN 
bit should be zero. 

If the length of the record is to be altered, the altered record must 
be built in an exit routine work area as a standard variable—length 
record. The address of the new record must be put into TWAREC and 
control returned to CWTR. The new, altered record replaces the old 
record. When the exit routine once again gains control, TWAREC is zero 
and a new message is pointed to by TWANXREC• 

If both the record at TWANXREC and the new record just described are 
to be inserted into the output stream, the TWAXTRTN bit must be set to 
one prior to returning to CWTR. The new record (pointed to by TWAREC) 
is sent to the terminal and control is returned to the exit routine with 
TWANXREC pointing to the original record; TWAREC is zero. This permits 
the exit routine to continue inserting records into the output stream 
until return to CWTR is made with the TWAXTRTN bit and TWAREC set to 
zero. 

A record can be deleted by returning control to CWTR with TWAREC 
containing the address of F*0 # . 

If dynamic storage is required by the exit routine, it can be 
acquired from storage control and saved by placing its address into 
TWAWA* 
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This chapter contains information on the conventions and general rules 
which must he observed when writing CICS/VS system initialization 
overlays. 

User-written overlays may be added to the system initialization 
program; however, the user is cautioned that the interface to user- 
written overlays is subject to change with later releases of CICS/VS. 

Overlays must conform to CICS/VS naming conventions. All system 
initialization overlays are seven-character names in the format DFHSIxy 
where "x 11 is a letter from A to Z and ,# y ,# is a number from 1 to 9. 
CICS/VS development reserves suffixes which end in 1 (for example, A1, 
B1,...Z1). User overlays may use any other two-character suffix. 

Overlay processing in system initialization is driven from the system 
initialization table SIMODS parameter. User-written overlays may be 
inserted at any point in system initialization processing, but the 
sequence of CICS/VS overlays must not be disturbed. Before attempting 
to add an overlay to system initialization processing, users should have 
a thorough knowledge of CICS/VS internals, be proficient in assembler- 
language coding, and have a reasonable knowledge of the operating system 
they are using. 

Because of the complexity of CICS/VS, various operating system 
considerations, and user needs, it would be impossible to describe in a 
single document all the considerations for coding user overlays. 

CICS/VS is responsible for common subroutine and overlay linkage 
(assuming these routines are not modified), and normal system 
initialization functions. The following are some general rules for 
overlay coding. 

• All overlays must be coded in assembler language. 

| • All overlays must include the DFHSICOM macro (system initialization 

common area); this provides all system initialization register 
| definitions, commonly used equates, and DSECTs, for the system 

| initialization communications area, DFHSIPDS, the system 

| initialization table, DFHSIT, the processing program table, DFHPPT, 

| and the common system area. Other DSECTs must be included as 

| reguired. 

• All overlays must contain the following two USING statements 

immediately prior to the first executable instruction. 

| USING *,SIPBAS2[,SIPBAR3] Establish program addressability 

USING SIPCOB,SIPBAR1 For common area addressability 

• All overlays must exit through the system initialization overlay 
supervisor. 

| • Overlays must not exceed 8,192 bytes. 

• The following is a list of system initialization subroutines 
available, and conventions for calling. 
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1. SIPCORE — common storage allocation subroutine for overlays 
executed before DFHSIB1 on CICS/DOS/VS and before DFHSIB1 on 
CICS/OS/VS. 

Calling Sequence 

L SICORA,=F*500* Load storage required 

L SILINKR,SIPCORE Get allocation routine address 

BALE SILINKR,SILXNKR Go get storage 

Return Sequence 

Symbolic register SICORA contains the address of acquired 
storage. All other registers are unchanged. 

Notes : 

• For CICS/OS/VS this routine is not available 
between DFHSIB1 and DFHSIH1, in which case 
OS/VS GETMAIN should be used* 

* After DFHSIH1, DFHSC TYPE=GETMAIN should be used for both 
CICS/DOS/VS and CICS/OS/VS. 

2. SIPBLDL — common BLDL subroutine 
Calling Sequence 

MVC SILISTID,=CL8"routine name* Move name 
L SILINKR,SIPBLDL Get routine address 

BALK SILINKR,SILINKR Go to routine 

Return Sequence 

SIPARMP3 — Contains storage required for load module 

SILISTTR — Contains TTRK for load module 

All registers are unchanged except 15. 

3. SIPLDER — system initialization program loader 
Calling Sequence 

Symbolic register SICORA contains storage address to load 
program. 

SILISTTR - Contains TTRK of load module 

L SICORA,=A(load point) Point at place to Load 

MVC SILISTTR,ttrk Move TTRK 

L SILINKR,SIPLDER Get loader address 

BALR SILINKR,SILINKR Go load module 

RETURN Sequence 

Symbolic register SICORA points at load point of program. All 
other registers are unchanged. 

4. SIPOSUP — system initialization overlay supervisor 

Calling Sequence 

L SILINKR,SIPOSUP Get overlay supervisor 

BALR SILINKR,SILINKR Go exit 

Return Sequence 
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None, transfer is given to the next overlay of SIP. 

The following areas are always addressable to system initialization 
overlays at entry, and must be addressable at exit. 

• CSA — Common system area 

• SIT — System initialization table 

• SIPCOM — System initialization common area 

• System initialization common routines 

The following fields are supplied as parameter-passing fields between 
user overlays of system initialization. These fields are not to be used 
by CICS/VS overlays. 


SIPARMP6 FULLWORD 
SIPARHP7 FULLWORD 

The DFHWTO macro instruction is provided for use within system 
initialization for conditional write—to—operator functions. If the 
MSGLVL in the system initialization table is one, all messages are 
written; if MSGLVL is zero, none are written. Any messages not to be 
suppressed in CICS/OS/VS should be written by means of the WTO macro 
instructions. The format for DFHWTO is: 

DFHWTO •MESSAGE UP TO 132 CHAR* 
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Chapt e r 6.5. Modifying the Terminal Control Table 


This chapter provides reference information on the macro and operands of 
the terminal control macro instruction interface (DFHTC CTYPE macros). 
The functions and relevant macro instructions of this interface are: 

• Scanning the terminal control table (DFHTC CTYPE=LOCATE) 

• Changing the status of a logical unit (DFHTC CTYPE=STAT(JS) 

• Checking the outcome of any of the above operations (DFHTC 
CTYPE=CHECK) 

| • Issuing a ACF/VTAM indicator (DFHTC CTYPE=COMMAND) 

| If an address is returned after a DFHTC CTYPE reguest, it should be 
| assumed to be valid only until the next CICS/VS reguest is issued. 

I CICS/VS reserves the right to reposition internal control blocks during 
| the execution of a transaction. Therefore, a new DFHTC CTYPE request 
| should be issued, after each CICS/VS request that causes a CICS/VS wait, 
j to re—address the control block. 

The DFHTC CTYPE macros should only be used by the system programmer 
when user—specific routines are written to handle recovery and error 
correction conditions. 

These macros are only available for use with the macro—level 
application programming interface, and only with assembler language. 

A description of the DFHTC CTYPE macros and operands follows. 

Note: The system programmer must specify DFHTCTZE CICSYST=YBS and 

DFHTCA CICSYST=YES in order to generate the system portions of the TCTTE 
and TCA DSECTs, which are required for any program that uses the DFHTC 
CTYPE requests and commands. 


TERMINAL LOCATE FUNCTION — DFHTC CTYPB=LOCATE 


The DFHTC CTYPE=LOCATE macro instruction may be used by the system 
programmer to: 

| • Find the TCTTE for a local or remote terminal, or a session. 

| • Find the TCTSE (system entry) for a route to a CICS/VS region in 

| the network. 

• Retrieve LDC information associated with a TCTTE. 

• Scan the TCT from top to bottom 

The locate function allows the system programmer to perform any of 
the above operations without being concerned with the structure of the 
terminal control table. For example, the system programmer can use the 
function to keep track of the availability of certain printers to 
schedule output to them, instead of implementing table—dependent 
I application programs to do so. 
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| | DFHTC | CTYPE=LOCATE | 

| | j i [ , DOMAXN= {LOCAJLi REMOTE j ALL J SYSTEM! SESSIONS} ] ( 

I | | [,ERROR=symbolic-address] | 

| | | [,INVADDR=symbolic—address] | 

| | | [ ,IN VID=symi>olic-address ] | 

| | | [,LASTTRM=symbolic-address] | 

| | | f ,LDC= (DEFAULT IYES1 1 | 

I I | | [ ,NETNAME= {FIRST|NEXT|ID} ] | 

I | | [,NORESP=symbolic-address] | 

| | | | r »TERM= (ADRIF1RSTIIP I NEXT 1 UNIQUE} 1 | 

|| | | [ ,XLATEID=UNIQUE] | 

I i-1-1---i 


CTYPE=LOCATE 

requests the address of a terminal entry or a system entry in 
the TCT and optionally, either the address of a LDC entry in 
the system LDC table, or the compound name which identifies the 
object found uniquely in the whole network; 


DOMAIN=(L OCAL IREMOTE I ALL I SYSTEM I SESSIONS! 

specifies the scope of the search to be carried out and implies 
the type of object to be found* The default is DOMAIN=LOCAL. 

LOCAL 

locate a full TCTTE describing either a terminal belonging 
to this CICS/VS region or a session connecting this region 
to another. The address of the TCTTE is returned in field 
TCATPTA. (Alternatively, a system entry (TCTSE) may be 
found, refer to TERM=ID.) 

REMOTE 

locate a model TCTTE describing a terminal belonging to 
another CICS/VS region; The address of the TCTTE is 
returned in field TCATPTA. This TCTTE contains all the 
known attributes of the remote terminal and the field 
TCTTESKA in the model points to the skeleton terminal 
entry, a small control block identifying the remote 
terminal to the home region. 


ALL 

locate either a full (belonging to the home region) or a 
model (describing a remotely—owned terminal) TCTTE. The 
address of the full or model TCTTE is returned in field 
TCATPTA, and the user must determine which type of TCTTE it 
is by testing its internal flags. 

SYSTEM 

locate a TCTSE (system entry) which identifies one named 
route to a CICS/VS region in the network, in this or 
another processor. There is always a local system entry 
which names the home region, and there may be indirect 
system entries which own terminals, but imply routing of 
all messages via an intermediate region. The address of 
the TCTSE is returned in field TCATPTA. 

SESSIONS 

locate a TCTTE related to a session with an identified 
remote region. The address of the TCTTE is returned in 
field TCATPTA• Only the TERM=FIRST and TBRM=NEXT formats 
are supported. 
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E RROR=sy mb ol ic^a dar ess 

specifies the entry label of the user-written routine to which 
control is to be passed if an error occurs. Errors passed to 
this exit routine are those not handled by INVADDR, INVID, 
INVREQ, or INVLDC• 


INV A D DR=s y m bo 1 ic-a d d re ss 

specifies the entry label of the user-written routine to which 
control is to be passed if the address specified in TCATPTA is 
not within the appropriate part of the terminal control table r 
not properly aligned, or zero for a DOMAIN=SESSIONS reguest. 
This operand is only applicable when an address is required in 
TCATPTA. 


INVID=symbolic-address 

specifies the entry label of the user-written routine to which 
control is to be passed if the identifier specified cannot be 
located in the relevant table. This operand is applicable with 
TERM=ID, TERM=UNIQUE, and NETNAME=ID• 


LASTTRM=symbolic-address 

specifies the entry label of the user-written routine. Control 
is to be passed to it if the address that was preset in TCATPTA 
was that of the last entry in the specified domain of the 
terminal control table with TERM =NEXT or NETNAME=NEXT, or, if 
the domain is empty, with TERM=FIRST or NETMAME=FIRST. 


LDC= fDBFAULT | YES} 

requests LDC information (the mnemonic, the numeric value, 
and/or the entry in the system LDC table or the extended local 
LDC list) associated with a specified TCTTE. If the LDC 
mnemonic is found, CICS/VS returns (in TCATPLDA) the address of 
the LDC entry and (in TCATPLDC), the LDC numeric value. The 
LDC operand causes CICS/VS to search the local LDC table for 
the LDC mnemonic. If the LDC mnemonic is found in the local 
table, the LDC numeric value is supplied from the local table 
(if the local table does not have the numeric value, the LDC 
value is taken from the system table). TCATPTA can be 
preloaded with the address of the TCTTE to be used; if TCATPTA 
is preloaded, the TERM operand must be given a value of ADR, or 
allowed to default. This operand does not apply to 3614 
logical units. 

Note: If an extended local LDC list exists for the terminal 

specified in the LDC operand, TCATPLDA is set to point to the 
extended local LDC list entry. 

YES 

indicates that the two—character LDC mnemonic to be used 
has been preloaded in TCATPLDM. If TCATPLDM is set to 
blanks, the default LDC (as explained in DEFAULT below) is 
used; the mnemonic of the default is returned in TCATPLDM 
along with the other LDC information located. If the LDC 
cannot be located, TCATPLDC and TCATPLDA are set to binary 
zeros. 
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DEFAULT 

indicates that the default LDC is to be determined for the 
specified TCTTE. The default is the first LDC in the LDC 
list associated with the TCTTE* The default LDC mnemonic 
is returned in TCATPLDM, the numeric value in TCATPLDC, and 
the address of the LDC entry in the system LDC table or the 
extended local LDC list in TCATPLDA. If the default cannot 
be located, TCATPLDM is set to blanks, and TCATPLDC and 
TCATPLDA are set to binary zeros. 


NETNAME={FIRST|NEXT|ID} 

specifies that a TCTTE is to be found in the local region, by 
reference to its NIB description* The DOMAIN operand must have 
a value of LOCAL or be allowed to default, and if the TERM 
operand is specifies it will be ignored. The values that can 
be specified for NETNAME are: 

FIRST 

returns the address of the TCTTE associated with the first 
NIB descriptor in field TCATPTA• 


NEXT 

returns the address of the TCTTE associated with the next 
NIB descriptor in field TCATPTA. Note that, on invocation, 
the field TCATPTA must contain the address of a TCTTE that 
has a NIB. 


on invocation, the field TCATPTA must contain the address 
of an 8—byte field containing the VTAM netname of a 
terminal or session. The address of the first TCTTE will 
be returned in field TCATPTA. 


NORESP=symnolic—address 

specifies the entry label of the user—written routine to which 
control is to be passed if the required operation was performed 
successfully. The address of the located entry is returned in 
TCATPTA. NORESP signifies normal response. 


TERM= {ADRIFIRST|ID|NEXT|UNIQUE} 

specifies the format of the data by which the entry is to be 
located. If the NETNAME operand is specified, the TERM operand 
will be ignored. The default is TERM=ADR. 

ADR 

indicates that no searching will be done. The address in 
field TCATPTA on invocation will be validated according to 
the value specified for the DOMAIN operand* TERM=ADR must 
be specified or allowed to default if the LDC operand is 
specified. TERM=ADR is valid with a DOMAIN value of LOCAL, 
REMOTE, or ALL. 

FIRST 

finds the first entry according to the value specified for 
the DOMAIN operand as follows: 
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• for DOMAIN=LOCAL, REMOTE, or ALL, finds the first 
terminal or session entry in the specified domain. 

• for DOMAIN=SYSTEM, finds the first system entry 

• for DOMAIN=SESSIONS, finds the first session in the 
TCTSE whose address is specified in field TCATPTA 
on invocation. 


NEXT 

given an entry address in field TCATPTA, finds the next 
entry of the same type in that domain. If the domain is 
local, either all system entries, or all the local region 
TCTTEs will be scanned according to the type of the entry 
provided* If DOMAIN has a value of ALL, the local region 
TCTTEs will be scanned before any model (remote) TCTTEs. 

If DOMAIN has a value of SESSIONS, only sessions under the 
same system entry as that supplied in TCATPTA are returned. 

If field TCATPTA is set to zero, the effect will be the 
same as specifying TERM=FIRST. 


ID 

finds the entry containing the 4—byte identifier of a 
terminal, session, or system that has been specified in 
field TCATPTA. Only DOMAIN values of LOCAL, REMOTE, ALL, 
or SYSTEM are valid with the operand. 

UNIQUE 

finds the full or model TCTTE corresponding to the two-part 
identifier specified. On invocation, field TCATPAPL must 
contain the eight—byte netname of a CICS/VS region, and 
field TCATPTA must contain the terminal identifier of the 
terminal in the remote region. This two-part 
identification uniquely identifies any terminal in the 
network of CICS/VS regions. The address of the TCTTE will 
be returned in field TCATPTA. Only DOMAIN values of REMOTE 
or ALL are valid with this operand. 


XLATEID=UNIQUB 

on successful location of a TCTTE, the unique identification of 
the terminal is returned as well as the address of the TCTTE. 
Field TCATPTA will contain the netname of the CICS/VS region, 
and field TCATPRMT will contain the identifier of the terminal 
in its own region. If the locate operation found a system 
entry then no unique identification is returned* 


CHANGING STATUS - DFHTC CTYPB=STATUS 


The DFHTC CTYPE=STATUS macro instruction should be used to perform any 
change of status, instead of directly altering bits in the TCTTE. The 
system programmer should be aware that, when CICS/VS emergency restart 
procedures are invoked following a catastrophic system failure, the 
status of each logical unit is set to the specification given in the 
original terminal control table; this is because none of the dynamic 
changes are retained across the failure. 
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I- 

| DFHTC 

i 

CTYPE=STATUS 

-1 


i 

i 

[,EKROR=symbolic-address ] 



i 

i 

[,INVADDR=symbolic-address] 



i 

i 

[,INVID=symbolic-address] 



i 

i 

[ ,INVLDC=symbolic—address] 



i 

i 

[,INVREQ=symbolic-address] 



i 

i 

[,LASTTRM=symbolic—address] 



i 

i 

[ ,LDC=YES3 




i 

[ ,STATUS = ([ INSBV |OUTSRV ] 



i 

i 

[ ,TRANSCEIVE|TRANSACTION|RECEIVE|INPUT| 



i 

i 

NOPOLL] 



i 

i 

[ ,PAGEIAOTOPAGE] 



i 

i 

[,ACQUIRE|RELEASE] 



i 

i 

[ ,COLD ]) ] 


L 

i 

i_ 

i 

[ ,TERB={FIRST|NEXT|ID} ] 

_1 


CTYPE-STATUS 

specifies that the status of a logical unit or an LDC is to be 
changed and/or the terminal entry is to be located. 


ERROR, XNVADDR, INVID, INVLDC, INVREQ, LASTTRM, and NORESP=symbolic- 
address 

are used to test the CICS/VS response to the request for 
STATUS. These operands can be specified in this macro 
instruction or in a DFHTC CTYPE=CHECK macro instruction. These 
operands are defined in the description of the DFHTC 
CTYPE=CHBCK macro instruction. See "Test CICS/VS Response to 
CTYPE Requests” which follows. 


LDC=YES 

requests the status change of an LDC represented by the 
specified LDC mnemonic in the system LDC table or in the 
extended local LDC list. TERM= and LDC=YES should be specified 
to change the status of an entry in the extended local LDC 
list; otherwise the system LDC list will be searched. The LDC 
mnemonic is specified in TCATPLDV by the user prior to issuing 
this request. 

The LDC operand can only be specified with PAGE/AUTOPAGE status 
change reguests. This operand does not apply to 3614 logical 
units. 

Note : If TERM= and LDC=YES are specified, the INVLDC condition will be 

raised if the extended local LDC list does not exist, or if the LDC 
specified does not exist in that list. The system LDC table is not 
searched if TERM is specified* 
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S TATU S=lo gical-m nit-status 

requests that the status of a logical unit or an LDC be 
changed. 

INSRV, OUTSRV, TRANSCEIVER TRANSACTION, RECEIVE, INPUT, NOPOLL, 
PAGE, AUTOPAGE, ACQUIRE, RELEASE, COLD 

indicate the status changes for the specified logical units 
or the LDC. The meanings of these status changes are as 
follows: 

An INSRV (in-service) logical unit is one that can 
either transmit and/or receive data with CICS/VS. 

An OUTSRV (out—of—service) logical unit is one that can 
neither transmit to nor receive data from CICS/VS. 

A logical unit in TRANSACTION status is used in the 
processing of transactions such as inquiries or order 
entries, but cannot receive automatic output* 

A logical unit in TRANSCEIVE status is a TRANSACTION 
terminal to which messages are sent automatically by 
the user. The automatic transaction initiation created 
by a transient data destination reaching a trigger 
level or by a time interval, such as message switching, 
sets a condition in an appropriate terminal control 
table terminal entry (TCTTE)• If the terminal status 
is TRANSCEIVE and if there is no transaction at the 
terminal, terminal control initiates the user—defined 
task. This task is expected to send messages to the 
terminal• 

A logical unit in RECEIVE status is one to which 
messages can ne sent but from which no input is 
allowed. 

A logical unit in INPUT status is one which can send 
messages to CICS/VS but cannot receive messages from 
CICS/VS * 

Not e; System messages may be routed to an input 
logical unit under conditions such as ATP batch count. 
This causes DFHZNAC to be scheduled. To handle this 
situation, the user should code a node error program to 
perform any user—required action. 

NOPOLL indicates that CICS/VS is no longer to attempt 
to read from the logical unit. 

PAGE indicates that all reguests to output data from 
the page supervisor are to be paged, unless specified 
otherwise in the DFHBMS macro or command. When paging, 
the first page from the paging supervisor is written 
when the logical unit becomes available* All 
subsequent pages in a page series are written on 
request of the logical unit (from the operator, if so 
designed) through the use of paging commands. 

AUTOPAGE indicates that all requests to output data 
from the page supervisor are to be automatically paged 
unless specified otherwise in the DFHBMS macro or 
command* When autopaging, the page supervisor writes 
all pages in a page series automatically. Requests to 
write data directly to the logical unit are not 
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controlled by the PAGE or AUTOPAGE parameters, because 
the page supervisor is not used for direct output. 

Note: PAGE and AUTOPAGE only apply to LDC=YBS or to 
TERM=* 

ACQUIRE indicates that the specified logical unit is to 
be acquired from ACF/VTAM. 

RELEASE indicates that the specified logical unit is to 
be released to ACF/VTAM. 

ACQUIRE,COLD indicates that the specified logical unit 
is to be acquired from ACF/VTAM but that message 
resynchronization is not to be attempted with the 
logical unit. This specification is enforced in the 
case of a 3270 Information Display System, the 
interactive logical unit (3767, 3770), and the batch 
logical unit (3770) ^ 


TERM={FIRST|NEXT|ID) 

indicates that a terminal entry is to be located and its status 
changed. If LDC=YES is specified with TERM=, the extended 
local LDC list for that terminal (if located) is changed, not 
the terminal entry. The address is returned in the TCATPTA. 

If both the TERM and LDC operands are omitted, TCATPTA is 
assumed to contain the address of the terminal entry for which 
the STATUS request is being made. 

FIRST 

indicates that the first terminal entry in the terminal 
control table is to be located. 


NEXT 

indicates that the terminal entry following that specified 
in TCATPTA is to be located. If TCATPTA is preset with 
binary zeros, the first terminal entry is located. 


ID 

indicates that the terminal entry with a specified terminal 
ID is to be located. TCATPTA must be preset with the 
terminal ID (left—justified) and padded with blanks (X^O 1 ) 
to fill the four-character field. 

If this operand is omitted, it is assumed that TCATPTA has been 
preset with the address of the terminal entry to be changed. 


TEST CICS/VS RESPONSE TO CTYPE REQUESTS - DFHTC CTYPE=CHBCK 


The general format of the DFHTC macro instruction to test the CICS/VS 
response to a preceding DFHTC request for LOCATE or STATUS is: 
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DFHTC | CTYPE=CHECK 

j [,ERROR=symbolic-address] 

| [,INVADDR=symbolic-address] 
| [,INVID=symbolic-address] 
j [ ,INVLDC=symbolic-address] 

| [,INVREQ=symbolic—address] 

| [ ,LASTTRM=symbolic—address] 
| [,NORESP=symbolic—address] 


CTYPE=CHECK 

indicates that the CICS/VS response to a DFHTC CTYPE=LOCATE or 
DFHTC CTYPE=STATQS request is to os checked. 


ERROR=symbolic-address 

specifies the entry label of the user—written routine to which 
control is to be passed if an error occurs. Errors passed to 
this exit routine are those not handled by INVADDR, INVID, 
INVREQ, or INVLDC• 


INVADDR=symbolic—address 

specifies the entry label of the user—written routine to which 
control is to be passed if the address specified in TCATPTA is 
not within the limits of the terminal control table, properly 
aligned, or zero for a TERM=NEXT form. This operand is only 
applicable when an address is required in TCATPTA. 


INVID=symbolic—address 

specifies the entry label of the user—written routine to which 
control is to be passed if the terminal ID specified in TCATPTA 
is not located in the TCT. This operand is only applicable to 
TERM=ID• 


INV LDC=symbolic—address 

specifies the entry label of the user—written routine to which 
control is to be passed if the LDC mnemonic is not found in the 
system LDC table or the extended local LDC list. This operand 
is only applicable to paging status requests for LDCs. 


INVREQ=symbolic-address 

specifies the entry label of the user—written routine to which 
control is passed if an erroneous bit setting is deleted during 
execution of the macro instruction. 


LASTTRM=symbolic-address 

specifies the entry label of the user—written routine to which 
control is to be passed if the address that was preset in 
TCATPTA was that of the last terminal entry in the table. This 
operand is only applicable to TERM=HEXT. 


NORESP=symbolic—address 

specifies the entry label of the user—written routine to which 
control is to be passed if the required operation was performed 
successfully. NORESP signifies normal response. 
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COMMAND OPTION FOR LOGICAL UNITS 


DFBTC CTYPE^COMMAND 


The system programmer can use the DFHTC CTYPB=COMMAND macro instruction 
to transmit indicators from CICS/VS to the logical unit application 
program. The system programmer should use the indicator interface to 
| request a ACF/VTAM function, rather than directly alter hits in the 
TCTTE, which could lead to unpredictable results if any future changes 
are made in the TCTTE internal structure. 

i ■ i ■ i ■ i 

| | DFHTC | CTYPE= (COMMAND[ ,W AIT ]) | 

|| | | [,COMMAND=indicator ] I 

i-1— -»---*---1 

I Note ; This macro instruction is not valid for ACF/VTAM-supported 3270s, 
and will cause an abend if so used. The macro may, however, be used for 
3270 compatibility mode logical units. 


CTYPE= (C0MMAND[ ,WAIT]) 

| specifies that a ACF/VTAM indicator is to be transmitted. The 

indicator is specified in the COMMAND operand. 


CO»MAND=indicator 

specifies the type of indicator to be sent. The following SNA 
data flow control and session control commands can be 
specified : 

BID 

requests permission to start a bracket for a particular 
TCTTE. CICS/VS uses the BID command as part of the ATI 
process for all logical units which use bracket protocol. 

CHASE 

forces any pending responses to be returned to CICS/VS. 
CLEAR 

resets all sequence numbers to zero, and puts the 
connection in the data flow reset state. No data may be 
sent to, or received from, the logical unit until the SDT 
command has been sent. Only session control commands (STSN 
and SDT) may be sent when the connection is in data traffic 
reset state. 

CANCEL 

requests the receiver to ignore the chained message 
currently being received. 


QEC 

quiesce—at—end-of-chain requests that a logical unit which 
is either out-of-service or in receive-only mode be 
quiesced (but not released from CICS/VS control) following 
the receipt of the message currently being transmitted from 
it. 

QC 

quiesce-complete is used by a node to respond to a QEC 
request to indicate that it is now in quiesce state. 

RQ 

release—quiesce is used by the node that issued the QEC 
request, and removes that node from the quiesce state. 
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SD-T 


start-data—traffic removes the specified connection from 
the data flow reset state so that the data and data-flow 
indicators may be sent* 


SIGNAL 

causes an expedited signal to be sent to the terminal 
SHUTD 

shutdown indicates that an end-of—day condition has been 
reached. SHUTD is sent by CICS/VS during termination of 
CICS/VS. 


STSN 

set—and—test seguence number is used during recovery from a 
failure to determine whether any in—flight messages were 
lost. 

ACF/VTAM indicators are always sent by CICS/VS with definite 
FME/DR1 response protocol requested* DFHZCP calls the 
appropriate routine and returns control to the requester when 
the response is received. 
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Chapter 6.6. CICS/VS External Security Interlace 


i 

i 

| CICS/VS provides an interface to an external security manager which may 
| oe user written or, for MVS only, may be the Resource Access Control 
| Facility (RACF) program product. 

| The following information is provided should the user wish to replace 
| any of the interface modules provided by CICS/VS with user written 
| versions. 


SECURITY MODULE - DFHXSP 


This module is used to perform standard CICS/VS security checking, 
resource level checking, and to invoke an external security manager. It 
is called at transaction attach, initialization, sign—on, and sign—off 
to perform initialization of the external security system or for 
resource verification. It is also called at MRO and ISC connect time, 
and from the mirror when scheduling a PS3. Access to the resources is 
determined by the return code set in register 15. 

On entry to DFHXSP, register 1 points to a parameter list described 
in the DSECT DFHSECDS which can be obtained by specifying the DFHSEC 
TYPE=DSECT macro instruction. The format of the parameter list is shown 
in Figure 6.6—1. 

0 r-, 


4 

8 

12 

16 

20 


24 


28 


| Figure 6.6-1. Parameter List for DFHXSP 


| Access | Request | | 

| flags | code I I 


Address of user id. 


Address of resource name 


Address of old password 


Address of new password 


Address of operator 
identification card text 


Address into which a user word 
(address of user block) can be 
stored or passed, or address 
of TCTTE. 


| pointer to resource class block 

L ., ...-.. .J 
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Valid request codes in the parameter list and their meanings are: 


0 Initial call 

4 Sign—on with password 

8 Sign-on without password 

12 Resource check 

16 Sign-off 

The number of fields passed in the parameter list will vary with the 
value of the request code as follows: 

0 Resource class name address field* 

4 User identification, old and new passwords, and operator 
identification card text address fields as appropriate, 
and the address for storage of the user word. 

8 User identification address field and address for 

storage of the user word. 

12 Resource class name address field, address of the TCTTE, and 
the address of the user word. 

16 Address of the user word. 

All character strings addressed by the parameter list, except the 
resource, consist of a one byte length field followed by the text 
string. The format of the resource class block is shown in Figure 6.6— 
2 . 


r 






~i 


flag 

| offset to 

| offset to 

1 

max. len. 

i 


byts 

| name in 

| CICS/VS RSL 

1 

of resource 

i 



| CICS/VS 

| byte in CICS/VS 

1 

name 

i 



| resource 

| resource 

1 


i 



| block 

| block 

1 


i 

i i 

i i 

i 

i 

t_ 






i 


Figure 6.6—2. Format of the Resource Class Block 


On return, DFHXSP should place one of the following codes in register 
15: 

0 Successful execution 

4 New password reguired 

8 Operator identification card required 

C Reserved 

10 Invalid sign—on attempt 

14 Invalid access to a protected resource 

18 External security failure or invalid parameter list 

In addition, register 0 may contain a user code in the range 0 to 99. 
If the external security manager is RACF, this code will be the RACE 
return code. In the case of an error occurring, this code will be 
inserted in the error message. 
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R ACF INTERFACE MODULE - DFHXSC 


This copy module is included in DFHXSP and is used to interface to RACF 
(on MVS only) by prefixing the resource name by the system name in the 
CSA optional features list (CSAXSNM) and making a direct call to RACF 
for a resource check or indirectly via the CICS/VS SVC for sign—on, 
sign—off, and initialization calls. 

If DFHXSC only is to be replaced, it must analyze the value of 
register 0 to determine the type of request. The values and their 
meanings, which are the same as for DFHXSP, are as follows: 


0 Initial call 

4 Sign—on with password 

8 Sign—on without password 

12 Resource check 

16 Sign-off 

On entry to DFHXSC, register 1 points to the parameter list (described 
in Figure 6.6—1) and register 10 addresses a 16 byte save area. 

Register 11 is the base register, and register 12 should not be 
corrupted. Appropriate return codes, as described for DFHXSP, should be 
set in registers 0 and 15, and the module should finish by branching to 
the contents of register 14. 


SECURITY IDENTIFICATION M ODULE - DFHACSB 


At initialization, and within module DFHIRP for MRO connections, the 
module DFHACEE is invoked. Its purpose is to return the security name 
of the system which is stored in the CSA optional features list for use 
in building the resource names for security checking. At MRO connect 
time the security name is passed to the other system for comparison with 
the value specified for the XSNAHE parameter in the TCT LINK entry and 
it is used to miild a security block for the linx. If the values are 
the same, the connection is allowed, however, if there is no value for 
the XSNAME parameter, any connection will be allowed. If the security 
names of the two systems are the same, then requests transmitted to the 
second system will not have security checks made against them. 

The system programmer can therefore control the degree of security of 
connections by writing a suitable version of DFHACEE. 

On entry to DFHACEE, only register 14 is set, with the return 
address. Registers 0, 1, 14, ana 15 may be used, and no other registers 
should be corrupted. The security name should be loaded into registers 
0 and 15, and return should be made via register 14. 
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Part 7. Data Sets 




Chap t e r 7.1. In tr oduc t io n 


This part of the manual contains reference information on certain 
operations that the system programmer may perform on data sets (files). 

The chapters in this part are: 


7.1. 

Introduction 

7.2. 

Dynamic Open/Close Function — which provides information on the 
DFBOC macro instruction which the system programmer may use to 
examine data sets during the execution of CICS/VS. 

7.3. 

Loading and Accessing Files that use Phonetic Codes for Keys — 
which describes the function that allows misspelled names to be 
used as keys to access data sets. 
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Chapter 7.2. D ynami c O PEN/CLOSE F unction 


This chapter contains reference information on the DFHOC TYPE=OPEN, 
CLOSE, and SWITCH macro instructions of the dynamic open/close function. 

The optional CICS/VS dynamic open/close facility allows the user to 
open/close data sets dynamically as often as desired during the real¬ 
time execution of CICS/VS. This makes it possible for the user to defer 
the opening of data sets during system initialization and open/close 
them later as they are needed. The dynamic open/close capability is 
applicable to file management (data base data sets), dump management 
(dump data sets), and transient data management (extrapartition data 
sets) and may oe invoked through the master terminal program or through 
the use of the DFHOC macro instruction in an assembler language 
application program. 

The Open/Close macro instruction (DFHOC) is used to request any of 
the following services: 

• Open, close, or switch dump data sets 

• Open or close data base data sets 

• Open or close transient data extrapartition data sets 

Note: The DFHOC macro instruction is intended for use by the system 

programmer as a means of system control; it should not be used by the 
application programmer to open/close data sets, because improper use of 
this macro instruction can cause serious degradation of system 
performance. 


OPENING DATA SETS — DFHOC TYPE=0PEN 


The programmer can open a data set or series of data sets by issuing the 
DFHOC TYPE=0PEN macro instruction. 


r 

| DFHOC 

| TYPE=0PBN 

-1 


i 

i 

| ,DATASET= {TEANSDATA|DATABASE|DUMP} 

| [,CHECK=symbolic—address] 



i 

| [ ,DSETID= (name[ , (xx) ],...) ] 



i 

i 

| [ ,LISTADE= {YES | (register) | (symbolic-register)} ] 

| [ ,M0DE=ICIP| (ICIP, {INIT|DYN} ) } 


1_ 

i 

i- 

| [,SYMBADE=symbolic—address] 

_L 

i 


TYPE=0PEN 

specifies that the open function is desired. 


DATASET= (TEANSDATA | DATABASE |D05!P} 

specifies the type of request. 

TEANSDATA 

indicates a transient data extrapartition data set. 
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DATABASE 

indicates a data base data set. 


DUMP 

indicates a dump data set. 


CHECK=symbolic—address 

specifies the symbolic address of a user—written routine to 
which control is passed if any error is detected during the 
OPEN operation. The user—written routine is given control 
whenever TCAOCTR in the TCA contains a non—zero return code. 

It is the responsibility of the user to examine the return code 
in the TCA and, if necessary, examine the individual error 
codes in the list that was built either by the user or by the 
expansion of the DFHOC macro instruction. The error code 
appears in the first byte of the third word of each entry in 
the parameter list. 

Upon return from the dynamic open/close program, TCAOCTR may 
contain one of the following hexadecimal codes: 


00 - No error 

FF - Invalid request 

or, if TCAOCTR contains neither of these codes, it will contain 
one or more of the following hexadecimal codes: 


80 — Open error 
40 — Close error 

20 - No space available for OPEN 
10 — Invalid control block name 

While performing the requested service on the list of data 
sets, the individual error bytes in the list entry are filled 
either with a hexadecimal 00 or with the proper error code each 
time an error is encountered. If more than one error is 
encountered while processing the parameter list, TCAOCTR 
reflects all the errors and perhaps a bit configuration 
different from those shown above. For example, there are six 
data sets to be opened; if four are successfully opened, and 
one has an invalid control block identification, and the other 
one has an open error, the TCAOCTR field contains a hexadecimal 
90. 

When there is insufficient storage available to open any data 
sets, TCAOCTR contains a hexadecimal 20, and all the entries 
contain a fullword (four bytes) of zeros in the third word. 


DSETID=name 

specifies the data set names or destination identifications to 
be used in constructing a parameter list. If a suffix is 
specified, it must be separated from the name or destination 
identification by a comma and must be enclosed in parentheses. 
This operand is not applicable if DATASET=DUMP is coded or if 
LISTADR or SYMBADR is used. 

If DATASET=DATABASE is coded, as many as 255 data set names can 
be specified with a single use of the DSETID operand. If 
DATASET=TRANSDATA is coded, up to 255 transient data 
destination identifications can be specified with a single use 
of the DSETID operand. Note, however, that the VSE assembler 
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will not accept a DSBT-IS operand in which the sum of the 
characters is greater than 255. 


If TYPE=OPEN is coded and if the destinations are nonresident, 
"xx," a two-character suffix of the data set control block (DCB 
for CICS/OS/VS, DTP for CICS/DOS/VS) lust he provided with each 
destination identification; if the destination is resident, the 
"xx* 1 suffix is ignored. 

In CICS/OS/VS, if »xx» consists of more than two characters, it 
is assumed to be the symbolic address of a list of options and 
parameters to be moved into the DCB. For the format of this 
list, see the discussion of the LISTADR operand in this 
section. 


LISTADR={YES|register|symbolic-register} 

specifies the address of the open/close parameter list built by 
the user. 

YES 

indicates that the address of the parameter list has been 
placed in the TCA at TCAOCLA. 

register 

indicates the register containing the address of the 
parameter list. 

symbolic address 

indicates the symbolic register name containing the address 
of the parameter list. 

This operand is not applicable if DATASET=D0HP is coded. If 
the LISTADR and SYMBADR operands are omitted, execution of the 
DFHOC macro instruction causes the list to be built for the 
user starting with the first byte of the TWA. In this case, it 
is the user*s responsibility to make sure that the required 
space is available in the TWA. The space can be calculated 
using the formula: 


Space = (n x 12) + 4 

where ,, n w is the decimal number of 12—byte entries in the 
open/close parameter list and the ,, 4 M represents four bytes of 
hexadecimal Fs to signify the end of the parameter list. 

The symbolic storage definition (DFBOCLDS) of a parameter list 
entry is provided by CICS/VS. The format of 12-byte entry in 
the open/close parameter list is: 
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TRANSDATA 


WORD 1: Four-byte destination identification* 

WORD 2: Four bytes of the form J$J$xx, where >fjzf is two 

bytes of blanks and xx is a two—byte suffix of 
the data set control block created by the DCT 
assembly, 

WORD 3: Error byte plus three—byte address of DCT entry 
(after completion) * 

DATABASE 

WORDS 1 and 2: Data set name (left justified, padded with 
blanks) . 

WORD 3: Error byte plus three—byte address of FCT entry 
(after completion). 

I Note ; The parameter list must be terminated by a hexadecimal 

I i FF T . 

In CICS/OS/VS, the user can optionally specify, in WORD 2 of a 
TRANSDATA entry, the parameter list address pointing to a 
storage area. This storage area contains information to be 
placed into a dummy DC3 before opening it. If an address is 
placed in this field, the first byte must be set to a 
hexadecimal FF. The symbolic storage definition (DFHOCODS) of 
this parameter list is provided by CICS/VS. The format of the 
parameter list is as follows: 


Byte 1: 

Byte 2: 

Byte 3: 

Byte 4: 
Bytes 5,6: 
Bytes 7,8: 
Bytes 9—16: 


Open options byte 

BUFNO byte 

RECFN byte 

ERROPT byte 

LRECL 

BLKSIZE 

DDNANE 


The first eight bytes must contain the correct hexadecimal 
codes for the desired parameters, since the 16 bytes of the 
open/close parameter list are moved into the DCB* 


NODE = {ICIP | INIT |DYN} 

allows the user to specify further options associated with the 
opening of files. This operand applies only to ICIP and mixed 
mode data base files, and is ignored for other types of files. 
The following operands may be used when NODE is specified: 
TYPE=OPEN, DATASET=DATABASE, DSETID= (NAME,...) , and 
CHECK=symbolic address. 

ICIP 

indicates that all ICIP and mixed mode files in the DSETID 
list will be opened in ICIP mode* If ICIP is not 
specified, the NODE option is ignored. 


INIT 

specifies that the in-core indexes are to be built during 
OPEN processing. This is the default specification* 
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DIN 


specifies that the in—core indexes will be built 
dynamically when the index control intervals are referenced 
during GET processing. Note that if NODE is not specified 
or is ignored in a DFHOC macro, the following defaults will 
apply: 


1. Mixed mode files will be opened in VSAM mode. 

2* In—core indexes for ICIP files will be built during OPEN 
processing. 

Note: This operand will override the option specified in the 
MODE operand of DFHFCT TYPE =D AT A SET• 


SYMBADR=symbolic-address 

indicates the symbolic address of an open/close parameter list 
built by the user. If the SYMBADR and LISTADR operands are 
omitted, execution of the DFHOC macro instruction causes the 
parameter list to be built for the user starting with the first 
byte of the TWA. For a discussion of the parameter list, see 
the discussion of the LISTADR operand in this section. This 
operand is not applicable if DATASET=DUMP is specified. 


CLOSING DATA SETS — DFHOC TYPE=CLOSE 


The programmer can close a data set or series of data sets by issuing 
the DFHOC TYPE=CLOSE macro instruction. The DATASET, LISTADR, SYMBADR, 
and CHECK operands have the same significance as in DFHOC TYPE=OPEN. 


i-1-1---» 

| | DFHOC | TYPE=CLOSE | 

| | | ,DATASET={TRANSDATA|DATABASEJDUMP} | 

| | | [,CHECK=symbolic-address] | 

I | | [,DSETID=(name,...) ] | 

| | | [ ,LISTADR= {YES | (register) | (symbolic—register)} ] | 

j j | [,SYMBADR=symbolic-address] | 

»- 1 - 1 - 1 


TYPE=CLOSE 

specifies that the close function is desired. 


DSETID=name 

specifies the names of the data sets to be closed. No suffix 
is required. As many as 255 data set names can be specified 
with a single use of this operand. Note, however, that the VSE 
assembler will not accept a DSETID operand in which the sum of 
the characters is greater than 255^ 

The DATASET, CHECK, LISTADR and SYMBADR operands are as described above 
in the DFHOC TYPE=OPEN macro instruction. 

Note : If a data set is being accessed by other transactions when it is 

closed, the other transactions may be abnormally terminated. 
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SWITCHING DUMP DATA SETS — DFHOC TYPB=SWITCH 


The programmer can switch from the dump data set currently being used to 
the alternate dump data set by issuing the DFHOC TYPE=SWITCH macro 
instruction. This macro instruction causes the current dump data set, 
if open, to be closed, and the alternate dump data set to be opened. A 
TYPE=CLOSE,DATASET=DUMP macro instruction does not cause a switch but 
only closes the current dump data set. 

| DFHOC | TYPE 35 SWITCH 
| | ,DATASET=DUHP 


TYPE=SWITCH 

specifies that the switch function is desired. 


DATASET=DUMP 

specifies that the dump data set is to be switched* 
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Chap t e r 7.3. Leading and Accessing Files that use 
Phonetic Codes for Keys 


This chapter explains how the DFHPHN macro instruction is used, and 
should be read in conjunction with the section on built—in functions in 
the appropriate CICS/VS Application Programmers Reference Manual . 

The major use of phonetic codes is for keys to data sets. In this 
way, records can be accessed even though the key may be misspelled. The 
phonetic code conversion subroutine (DFHPHN) is provided to assist the 
user in loading and accessing such data sets offline. DFHPHN is 
generated by specifying the CICS/VS built-in functions program DFHSG 
PHOGfiA«=BFP (CICS/OS/VS only). For CICS/DOS/VS, DFHPHN must be 
assembled by the user. 

This offline subroutine provides the facility to convert a 16- 
character name to a four—byte phonetic code. See the Built-In Function 
macro instruction (DFHBIF TYPE=PHONETIC) in the CICS/VS Application 
Programmer*s Reference Manual (Macro Level) for the rules of the 
conversion. 

This function can ne invoked oy a program running under any of the 
operating systems under which CICS/VS can be run. The calling format 
is: 


CALL DFHPHN, (lang,name,phon) Assembler 

CALL DFHPHN (lang, name ,phon) PL/I 

CALL * DFHPHN • USING lang name phon COBOL 

where: 


lang 

is the symbolic address of a field which contains a one- 
byte language indicator. 

If an error occurs during processing of this request, X § 50 # 
is returned in this location. If no error occurs, X*00 fc is 
returned and the location must be reset to indicate the 
programming language before the location can ne reused. 


X•FO• indicates assembler or COBOL 

X t 'F1 i indicates PL/I 


name 

is the symbolic address of a field which contains the 16- 
character name. 

phon 

is the symbolic address of a field in which the 4—byte 
phonetic code is returned. If the first character of the 
••name 11 field is not alphabetic (A to Z) , the "lang" field 
will be set to X l 50 l . 
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The steps in loading such a data set would typically be: 

1. Create the keys* 

a* Read a record from the source data set. 

b* Generate the code through a call to the DFHPHN subroutine 
c. Write the record on a temporary sequential data set. 

2. Sort the temporary data set on phonetic code. 

3. Load the key—sequenced VSAM data set* 
a. Read the sorted temporary data set. 
b* Write to the keyed data set. 
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Part 8. Host Processor Resource Estimation 
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Chapter 8.1. Introduction 


This section of the manual describes simple techniques and provides 
approximate data to allow the system programmer to estimate the amounts 
of the main resources in the host processor that are necessary to run a 
CICS/VS system. These resources are: 

• The processor 

• Virtual Storage 

• Real storage (reference set storage) 

• The I/O devices 

They are discussed in suosequent chapters in this part of the manual. 
Furthermore, each chapter contains a number of tables that provide data 
about CICS/VS functions to allow the user to estimate the usage of these 
resources. Chapter 8.6 discusses how to use the estimates of the 
various resource requirements to estimate approximate response times and 
maximum loadings of the host processor. No attempt is made to provide 
data or techniques to estimate total system response, maximum loading, 
resource estimates of other resources (for example, communication 
lines), or to estimate host processor resource utilization by other 
applications (for example, batch or TSO). Chapter 8.7. gives examples 
of the use of the data and of the estimating techniques. 

In order to accomplish the above objectives, it is essential that the 
system programmer has equivalent information about the major application 
programs used in the CICS/VS system* 

Further information on the performance aspects of CICS/VS can be 
found in the CICS/VS System/Application Design Guid e and in the 
appropriate CICS/VS System Programmers Guide . 

The information presented in this manual should assist the reader to: 

• Estimate the host processor requirements for the CICS/VS system 

• Estimate upper and lower limits of response and maximum load in the 
host processor 

• Evaluate function/performance/cost tradeoffs during the system and 
application design processes 

• Estimate the ability of the host processor to support expansion of 
the existing system. 

Although it is believed that the data given in the following chapters 
i s correct, and that the estimating techniques are valid, no guarantee 
is given that any data or any of the techniques described will give an 
a ccurate re sul t for any given system . 
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This chapter contains advice on how to estimate the host processor 
utilization for a CICS/VS system. Processor utilization can be defined 
as the ratio of the time that the processor is busy (in a particular 
period) to the length of the period. The result is often expressed as a 
percentage. 

In practice, for a given set of transactions in a given system, the 

processor utilization is a complex function of the transaction rate. 

However, in most cases it has been found that over a reasonable range of 

transaction rates the curve can be approximated by a straight line of 

the form: 


U= A + B*R ...Equation 1 

where ,, A ,t and ,t B ,f are constants, "fi” is the overall transaction rate per 
second, and is the utilization expressed as a value between 0.0 and 

1 . 0 . 

Figure 8.2—1 shows an example of a real curve and an approximation of 
the processor utilization. In some cases, where there is a wide range 
of transaction rates under consideration, a better approximation can be 
obtained by using more than one straight line to fit the real curve for 
different ranges. However, in practical cases the transaction rates of 
interest are usually in a small enough range to give satisfactory 
results with only one straight line. 

The System/370 range of processors on which CICS/VS is run extends 
from the model 115—0 to the 3033. The fastest machine in the range (the 
3033) will, on average, execute instructions about 90 times faster than 
the model 115—0. However, it should be remembered that, because of 
differences in the design of the processors, the ratio in speeds for 
any two processors will vary according to the type of instruction 
executed. 

For CICS/VS systems, it has been found, over a wide range of 
transactions, that it is a reasonable approximation to multiply the time 
taken to execute the instructions necessary to perform any particular 
transaction on one processor and to multiply it by a common factor, 
which is independent of the transaction, to obtain the time on a 
different processor. 

If a particular processor is taken as a standard, a set of factors 
(referred to in this manual as the Relative Power Factor (RPF)) can be 
used. A table of these factors (Table 4) is given later in this 
chapter. 

For convenience, the reference chosen is a hypothetical processor 
whose RPF is 1000. All times used in this chapter are in milliseconds 
and are "measured** on the hypothetical processor whose RPF is 1000. 
Hence, to convert from the time on the hypothetical processor to the 
time on a real processor, any result should be multiplied by 1000/RPF. 
For example, if the time a transaction required on the hypothetical 
standard processor was 300 milliseconds, the time on a System/370 model 
145 (whose RPF=350) would be: 
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300 x 1000 
350 

- 857 milliseconds 



Figure 8*2—1. Processor Utilization against Transaction Rate 


The calculation of the host processor utilization based on this 
approximation is done in various stages, as follows: 

1* Identify the most frequently used transactions, itemize both the 
CICS/YS functions used and the number of times they are called in 
each transaction invocation, and define or measure the transaction 
rate for each transaction. 
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2. Calculate the processor "busy time” for each of these transactions, 
using the table of timings given later in this chapter. 

3. From a knowledge of the transaction rate and the processor busy 
time of each transaction, calculate the processor utilization for 
each transaction type. This processor utilization is then to be 
converted to the utilization that would occur on the real machine. 
The average value taken over all the transactions is the constant 
"B" in Equation 1. 

4. Calculate the processor utilization that is taken up by CICS/VS and 
by the operating system independently of any particular 
transaction. This is the constant "A 11 (see Equation 1) and is 
called the background pro ce ssor utilization . This should not be 
confused with instructions executed by the background partition in 
VSE systemsi 

5. The results of (3) and (4) are summed to give the total processor 
utilization taken up by CICS/VS and the application programs. If 
other subsystems (for example, batch) are running in the same 
processor, these must be estimated separately. 

Each stage is discussed in the sections that follow. A detailed 
example is given in Chapter 8.7. 


DEFINING THE TRANSACTIONS AND TRANSACTION RATES 


A CICS/VS transaction can be divided into two parts: 

• The system part 

• The application—dependent part 

The system part involves initialization and termination of the 
transaction, and the application-dependent part contains the CICS/VS 
macros or commands issued by the application program, together with the 
application code itself* Bach CICS/VS function used should be 
tabulated, together with the number of times it is used in each 
transaction. 

Three major types of transaction exist, which are used to 
characterize the system component. These types are: 

• Non—conversational, which consist of accepting input from a 
terminal, initiating the transaction, sending the reply or "echo 11 
back to the same terminal immediately, and terminating the 
transaction. 

• Conversational, in which a conversation is held between the 
terminal and the application program involving several inputs and 
the same number of outputs. From an estimating point of view, the 
total transaction is split into several "conversational echoes" 
each consisting of one input, reactivation of the dormant 
transaction, and outputting the reply, together with any other 
processing necessary before the next input. 

• Automatically initiated transactions, which are initiated by means 
other than a terminal input, are classified separately. They 
consist of the initiation process (for example, time initiation) 
and the termination process. The system part is assumed not to 
include any communication with a terminal. 
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The main transactions in a system are either definable (during system 
design) or can be identified by an analysis of a running system by using 
such tools as CICS/VS statistics or the CICS/VS Performance Analyzer. 
Similarly, the individual transaction rates can be obtained; Each 
transaction type should then be analyzed to find the system type and the 
application—dependent functions used in the transaction. Having done 
this, the next step is to calculate the time taken by the processor to 
execute the transaction instructions. 


CALCULATING TRANSACTION EXECUTION TIMES 


A first approximation to the processor busy time (P) of a CICS/VS 
transaction can be represented by: 

P= a 0 + a t + b*L + c*T + d*T/L Equation 2 

where: 

n a 0 H , l, a 1 M , M b M , "c”, and ,, d n are constants for a given system 

and 

"L 11 and tt T M are the total number of lines and terminals 
attached to the system. 

The term "ao” is the system component and is the sum of 

contributions from the application—dependent part. Values of ”a 0 " can 
be obtained from data in Tables 1 and 2, whilst ,l a 1 M values can be found 
in Table 3. The time taken to execute the application program itself, 
on the hypothetical standard processor, must be added to the #l a 1 H value. 

This application value can be found by several means, as follows: 

• Estimate or measure the application pathlengths, divide the answer 
by 1000, and add the result to the "ai" value. 

• Or: measure the times by using a hardware monitor, and convert 
these to standard processor times by using the RPF values in Table 
4. The result is added to the » , a 1 M value. 

• Or: make a crude estimate as follows: 

— for applications that do little else other than call CICS/VS* 
add 5% to the "aj" value 

— for other applications, add 10% to the "aj” value 

The appropriate system and application functions for each transaction 
are selected as described in "Defining the Transactions and Transaction 
Rates”, and a total of the ”a 0 ” and "at 11 values is obtained for each 
transaction. 

The network component of the execution time b*L + c*T + d*T/L, which 
is part of the system component, is then calculated. The constants ”b”, 
"c", and ,, d M are functions of the TP access method, terminal type, and 
release of CICS/VS* Values for these constants are given in Table 2. 

The result will be in milliseconds* 

When network components have been obtained for each transaction, they 
should be added to the ,, a ,t values obtained to give the total time. 

Where there is additional terminal I/O besides that of the system 
component, an additional network component should be added at the rate 
of one half the original network component value for each additional 
I/O. The timings should then be tabulated for each transaction type. 
Refer to Chapter 8.7. for examples. 
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CALCULATING TRANSACTION PROCESSOR UTILISATIONS 


The timings for each transaction should now be converted to "time per 
second 11 by multiplying each transaction time by the individual 
transaction rates for each transaction. The results should then be 
summed over each transaction to give a total value for the busy time per 
second on behalf of all the transactions. 

As discussed above, each processor type is characterized by a 
processing power expressed relative to the power of the "’ hypothetical 
standard processor 11 executing a dedicated CICS/VS system. For 
convenience, the power of the "hypothetical standard processor" is taken 
as 1000. Values for a range of processors are given in Table 4. 

It has been observed that wide variations of execution speed can 
occur for different types of programs. However, for a wide range of 
CICS/VS programs, the variation in execution speeds is sufficiently 
small to enable a single average value to be used for a particular 
processor. These values are shown in Table 4. No guarantee is given 
t hat the relative values in Table 4 will represent any particular 
environment and they should not be assumed to represent any system other 
than one that is dedicated to CICS/VS . 

From this table, the appropriate relative processing power factor is 
selected. The total busy time per second is then divided by the 
relative power to give the processor utilization term M B*R" in Equation 

1 . 

Hence, if there are 11 k 11 transactions and " P- ” is the processor 
busy time of the « £ th ” transaction and « R • ” is the transaction rate 
of the same transaction, "B*R 11 is given by: 


B*R = (1/F)[ PiRi + P 2 R 2 + *.^P; Hj + * # * P k R k 3 *i.Equation 3 

where: 

"F" is the processor relative power factor 
«R” is the total system transaction rate 


CALCULATING THE BACKGROUND PROCESSOR UTILIZATION 


Background processing occurs primarily because CICS/VS periodically 
scans terminal control tables and wait lists to see if any worK is to be 
initiated. Other instructions may also be executed because the 
operating system also periodically scans tables. Note that the term 
"background processing" should not be confused with batch jobs executing 
| in the VSE background partition. 

However, because it is the purpose of this estimating technique to 
use the straight line approximation (see Figure 8.2) it is necessary to 
use the value "A" rather than the actual value "A*”. 

However, both "A” and »A*» are dependent on the operating system, the 
network size, and the CICS/VS ICV parameter specified in DFHSIT. 
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An appropriate value for »A» can be calculated as follows: 


• Calculate the processor time (P) to execute an ICV interrupt from 
the equation: 

P= X + Y*L + Z*T + V ...Equation 4 

| where M L fl and ,, T H are total numbers of BTAM lines and terminals 
and "X", ,, X”, ,, Z , « # and «V» are constants given in Table 5, at the 
end of this chapter. 

If "F" is the relative processor power in Table 4, and ICV is the ICV 
value in milliseconds, »A” is given by: 


A= 1000*P/(ICVxF) ...Equation 5 

For most systems this value should lie between 0 and 0.05 (that is 
5%). If an OS/VS system is being used, the operating system makes 
another contribution to the ••A 11 value. An estimate for an OS/VS2 
Release 2 and later (MVS) system is 0.002 (0.2%) per address space. No 
measured figures are available for 0S/VS1, but a value of 0.01 to 0.02 
(between 1 and 2ft) should be taken. 


TOTAL PROCESSOR UTILIZATION 


The "A” and ,, B*R 11 values calculated in the previous section are added to 
give the total processor utilization due to CICS/VS. If other jobs are 
running in the same processor (for example, batch, IMS/VS), allowance 
must be made for the processor utilization of these items. 

Until now it has been implicitly assumed that the number of page- 
fault I/Os is close to zero. Although it is relatively easy to 
calculate the increase in processor utilization when the number of page- 
faults that occur per second or per transaction is known, no simple 
technique has been found to calculate the number of page—faults that 
will occur in any situation. The only reliable technique is to measure 
the number of page—faults and then to estimate the processor utilization 
for various numbers of page—faults to investigate the relative effect on 
the overall processor utilization. 

In practice, although a processor utilization in excess of 95ft can be 
achieved, it is preferable to assume that 80ft will be the upper limit, 
to preserve reasonable response times. Reference should be made to 
Chapter 8.6 for further discussion on this subject. 


TABLES 

The tables given in this section are: 

• Table 1 — CICS/VS system component timings 

• Table 2 — CICS/VS network component timings 

• Table 3 — CICS/VS application function timings 

• Table 4 — System/370 processors — relative power factors 

• Table 5 — CICS/VS background timings 
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The following notes apply to all the tables: 

• All timings are in milliseconds "measured” on the standard 
processor. 

• All timings are approximate. They are intended to represent medium 
size installations in normal situations running applications of 
average complexity. Where systems are generated to include all 
functions, and where the data base structure is very complex, 
timings will be higher than those guoted. For small simple 
systems, timings can be less. A sensible level of tuning is 
assumed, that is to say, the system programmer should be familiar 
with the information in the appropriate CICS/VS System Programmers 
Guid e and should have put the more significant guidelines into 
action. 

• Timings represent the current release of CICS/VS unless 
specifically stated otherwise. 

• Items marked «—" indicate that reliaole data is not yet available. 

• Items marked "NA 11 indicate that the particular function does not 

| exist (for example, VSAM ICIP under VSE) . 


TABLE 1. 


1- 

| Transaction Type 

| VSE 

i 

OS/VS1 1 

0S/VS2 (NTS) | 

1 ECHO 

i 

i 


i 

i 

1 

1 


| BTAM 3270 BSC 

i 

22*0 

i 

22.5 | 

25.0 | 

| 3270 Local 

i 

10.0 

i 

14.5 | 

16.0 | 

| Start/Stop 

i 

19*5 

i 

21.0 | 

23.0 | 

| Start/Stop point-to-point 

i 

i 

14.2 

i 

i 

15.5 | 

1 

17^0 | 

| VTAM 3270 Local 

1 

i 

17.5 

1 

i 

22.0 | 

20.0 | 

| 3270 BSC 

« 

18.5 

i 

22.4 | 

23.0 | 

3270 SNA (3274/3278) 

i 

15.0 

i 

18*0 | 

20.0 | 

| 3600—SNA 

i 

15.0 

i 

18.0 | 

20.0 | 

| 3790—SNA 1 

i 

20.0 

i 

28*8 | 

32.0 | 

] 3790—3270 emulation 1 

i 

i 

21.0 

i 

i 

27.6 | 

i 

31.0 | 

| Authorized Path VTAH + CICS/VS 

1 

i 

NA 

1 

i 

1 

NA | 

12.5 | 

| HPO (3600, 3270 SNA) 

i 

i 


i 

i 

1 

1 


| Primed storage — deduct from 

1 

i 

NA 

l 

i 

-1.0 | 

-1.0 | 

| all ECHO values except HPO 

i 

i 


i 

■ 

1 

i 


1 Conversational ECHO 

1 

i 

i 

—USB 

i 

ECHO VALUES— | 

■ i 

1 Automatic Initiation 

i___ 

1 

i 

i 

4.5 

i 

i 

i 

4.9 | 

1 

5.2 | 

1 

1 


Table 1. Base Transaction Timings (in milliseconds) 

Notes : 

1. Includes processing of mandatory definite response from 3790 when 
CICS/VS sends End Bracket on the (last) write. 
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2. All values given assume the ECHO is written in assembler (macro 
level), occupies the first position in the program control tanle, 
and is resident in virtual storage. 

The CICS/VS application function timings given in Table 3 later in 
this section are in milliseconds and represent ••average* systems. 
Variations will occur because of different options in the operating 
systems, access methods, CICS/VS, and with the size of the 
installation. Hence, all values are approximate but are believed to be 
individually correct to within plus or minus 10% for the majority of 
configurations. 

| The timings given represent CICS/VS Version 1, Release 5, unless 
otherwise stated. 

The l# NA w symbol indicates that the pathlength data is not applicable 
to a certain function, and indicates that information is not yet 

available for that function. 

No guarantee is given that these timings accurately represent any 
particular environment. 


mLB-2-i 


r~ 

ACCESS METHOD/ 

| VSE 



| 0S/VS1 | OS/VS2 I 


TERMINAL 

i 



1 

1 




1 B | 

1 

c 

1 D 

1 B | 

C 1 D 1 B 1 

C 1 D I 



1 

1 1 


1 

1 1 

1 1 1 

1 1 


BTM (CICS/VS 1.3) 

1 1 


1 

1 1 

I 1 1 

1 1 


BSC 3270/L3270 

| 0.06| 0 

.05510.20 

|0.06|0 

• 03 10 .20 | 0.06 10 

.03|0.20| 


Start—Stop 

|0.06|0 

.040 

|0.17 

|0.06|0 

. 0210.17|0.06 | 0 

. 0210.171 


Point-to-point 

|0.35| 

1 1 

0 

1 o 

1 

|0.30| 

1 1 

1 1 

0 | 0 |0.30| 

1 1 1 

1 1 1 

0 I 0 | 


BTAM (CICS/VS 1.4 

1 1 

1 1 


1 1 
1 1 


and later) 

1 1 


1 

1 1 

1 1 1 

1 1 


BSC 3270/L3270 

10.121 

0 

|0.24 

|0.12| 

0 |0.24|0.12| 

0 |0.24 | 


Start—Stop 

10.121 

0 

10.2 

|0.12| 

0 |0.20|0.12| 

0 |0.20 | 


Point—to—point 

10.351 

I 1 

0 

1 o 

1 

1 

|0.3 | 

| | 

0 | 0 |0.3 | 

1 I t 

1 1 1 

0 I 0 | 

1 1 


VTAM 

1 1 

1 1 


! 1 

i i 

1 1 

1 1 

L_ 

All devices 

1 0 | 

0 

1 o 

1 0 i 

0 | 0 | 0 | 

0 | 0 | 
_ 1 


Table 2. Values for Line and Terminal Constants (B, C, and D) in 
milliseconds 


Notes: 

1. Values for local 3270 networks are not currently available. Remote 
3270 figures should be used as a first approximation. 

2. In practice, the variation of CICS/VS pathlength with network size 
is a very complex function of network size and type, TP access 
method, transaction rate and CICS/VS functions used. The values 
given will only give an order of magnitude value. 

3. For very high message rates (>5/second), the DOS/VS *C* values for 
CICS/VS 1.3 should be halved. For very low message rates 

(<0.5/second) , the OS/VS «C* values for CICS/VS 1.3 should be 
doubled. In practice, in both cases the transition from one »C* 
value to the other will be a smooth function of the message rate. 
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4. The DOS/VS valued for CICS/VS 1*3 assume that the ICVTSD value is 
set to zero. A higher value will decrease the pathleugth. At one 
second it should be similar to the CICS/VS 1.3 values for OS/VS. 

| 5. The CICS/VS 1*5 Figures show for release 1.4 and later significant 

improvements for large multipoint networks. The improvement shows 
where there are more than 3 terminals per line. 
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TABLE 3 


Application Function 


Terminal Control 


3270 Local 

READ 

| 3.4 

1 5.1 

| 6.1 


WRITE 

| 3.5 

1 3.7 

| 4.8 

3270 BSC 

READ 

| 6.1 

| 5.6 

| 6.8 


WRITE 

| 10.3 

| 9.2 

| 10.4 

3270 Local 

READ 

1 7.1 

| 9.7 

| 6.7 


WRITE 

| 6.4 

| 8.9 

| 7.0 

3270 BSC 

READ 

1 7.5 

| 9.0 

| 8.0 


WRITE 

| 5.4 

| 6.3 

| 7.7 

3270 SNA 

READ 

| 7.0 

1 7.5 

| 7.7 


WRITE 

| 4.7 

| 6.0 

I 6.2 

3790 

READ 

| 7.0 

1 7.5 

| 7.7 


WRITE 

| 4.7 

| 6.0 

| 6.2 

3600 

READ 

| 7.0 

1 7.5 

1 7.7 


WRITE 

1 4.7 

l 

| 6.0 
• 

| 6.2 
| 

VPACING RESPONSE 1 

| 2.8 

i 

1 3.7 

| 4.2 

PUNSOL=YES 

(L3270 and 

| 2.0 

| 2.3 

| 2.5 

BSC only) 
RESPONSE to 

input data 

! 

| 4.2 

1 

| 5.5 

1 

| 5.7 

RESPONSE from terminal 

I 4.7 

fe 

| 5.8 

1 

| 6.8 

for authoriz 

ed path 2 

READ 

1 

1 

| NA 

1 

1 

) NA 

1 

1 

1 1 -2 


WRITE 

| NA 

i 

| NA 

i 

| 1.8 
k 

MSGPBBQ=PROTECT (PCT) 

Add to ECHO (VTAH only) 

1 

i 

i 

| 27.0 

1 

I 


Basic Mapping Support 
(excluding terminal I/O pathlengths) 


Output - DATA=YES BASE 

1.5 

1 1.7 

1 1.7 

Add (per field) 

0,12 

| 0.12 

| 0.12 

Subtract (per null Field) 

-0.05 

| -0.05 

I -0.05 

DATA=ONLY BASE 

1.5 

I 1.7 

1 1.7 

Add (per field) 

0.035 

| 0.035 

| 0.035 

Add (par DATA field) 

0.08 

| 0.08 

| 0.08 

Subtract (per null DATA 

-0.05 

| -0.05 

| -0.05 

field) 




DATA=NO BASE 

1,3 

| 1.5 

1 1.5 

Add (per field) 

0.07 

| 0.07 

1 0.07 

Add (per FORMAT field) 

0.05 

| 0.05 

| 0.05 

Primed storage —deduct from BMS Base 

NA 

| 0.2 

| 0.2 

input (TYPE=MAP or TYPE=IN) 




BASE 

1.8 

| 2.0 

| 2.0 

Add (per changed field) 

0.12 

| 0.12 

| 0.12 

Primed storage , deduct BASE 

NA 

| 0.3 

| 0.3 


VSE | 0S/VS1 | 0S/VS2 | 

(Times in milliseconds) | 


Table 3. (Part 1 of 6) CICS/VS Application Function Timings in 
Milliseconds on the Hypothetical Standard Processor 
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Application Function 

| VSE | 0S/VS1 | 0S/VS2 

| (Times in milliseconds) 

— i 

r~ 

Map location (excluding PPT search) 

1 

1 


i 

i 




Resident in virtual storage 

| 0.25 

| 0*25 

i 

0.25 



Not resident in virtual 

| 3.5 

| 7.0 

i 

8.0 



storage 

1 

1 


i 

i 




Procrram Control 

1 

1 

I 


1 

1 

a 




a) Resident programs and maps 

1 

I 


1 

1 




(and non-resident programs and 

1 


1 




maps already in core) 

1 


1 




LINK+RETURN 

| 0.42 

| 0.42 

1 

0.42 



XCTL 

| 0.12 

| 0.12 

1 

0.12 



LOAD 

| 0.25 

i 

| 0.25 

1 

0.25 



b) Non-resident programs and maps 

i 

i 


i 

1 




LINK+RETURN 

| 2*4 

1 7.4 

1 

8.4 



XCTL 

| 2.1 

1 7.1 

1 

8.1 



LOAD 

| 2*0 

| 7.0 

l 

8.0 



DELETE 

1 — 

1 — 

1 

— 



(These exclude the PPT search — see 

i 


1 




Table Search pathlengths, below) 

i 

i 


1 

a 




c) High-level language support 

i 

i 


i 

1 




(macro level) 

i 


1 




PL/I per program called 

1 1.1 

1 1*1 

1 

1.1 



per macro call 

| 0.02 

| 0.02 

1 

0.02 



COBOL per program called 

| 0.45 

| 0.45 

1 

0.45 



per macro call 

| 0.04 

i 

| 0.04 

1 

1 

0.04 



d) Command-level language support 

1 

i 


1 

1 




These timings should be added 

i 


1 




to the macro level timings for 

i 


1 




the same language. For RPG II add 

i 


1 




to assembler macro data* 9 

i 

• 


1 

1 




PL/I ECHO 

1 1.3 

1 1*3 

1 

1 

1 *3 



CICS/VS calls 

| 6% 

1 

| 6* 

1 

a 

6% 



Assembler ECHO 

1 1.3 

1 1.3 

1 

1 

1.3 



Other calls 

| +6% 

1 

| +6% 

1 

I 

+ 6% 



COBOL ECHO 

1 

| 2.2 

| 2.2 

i 

1 

2.2 



Other calls 

| 6 % 

| 

| 6% 

1 

I 

6* 



RPG II ECHO 10 

| 11.0 

| NA 

1 

1 

NA 


L. 

Other calls 

| +6% 

1 

| NA 

1 

1 

NA 

_i 


Table 3* (Part 2 of 6) CICS/VS Application Function Timings in 
Milliseconds on the Hypothetical Standard Processor 
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1 1 

1 

Application Function 

| VSB | OS/VS1 | 0S/VS2 

| (Times in milliseconds) 

r~ 

i 

i 

Storacre Control 

1 

i 

i 

1 

i 

i 

GETMAIN + FRBSMA IN (normal) 

| 0.3 

| 0.3 

| 0.3 

i 

If one or more new pages are 

) 

1 

1 

i 

needed, add: 

| +0.7 

| +0.9 

| +0.9 

i 

i 

Primed storage 

| NA 

i 

| 0.07 

1 

| 0.07 

1 

1 

1 

Journaling 

f 

1 

1 

1 

1 

1 

1 

k 

1 

i 

GETJCA (not requiring new page) 

| 0.17 

| 0.17 

| 0.17 

i 

POT STARTIO=YES - DISK 

| 2.4 

i 3.8 

| 4.0 

i 

- TAPE 

| 2.4 

| 3.6 

| 3.7 

i 

STARTI0=N0 3 - no I/O 

I 0.13 

| 0.13 

| 0.13 

i 

- DISK I/O 

| 3.3 

| 7.3 

| 7.8 

i 

WRITE STARTIO=YES - DISK 

| 1.9 

| 3.5 

| 3.7 

i 

- TAPE 

| 1.9 

1 3*4 

| 3.5 

i 

STARTI0=N0 3 - no I/O 

| 0.13 

| 0.13 

| 0.13 

i 

- I/O 

| —USE STARTIO=YES 

values— 

i 

WAIT (block to be written) 

I 3.1 

| 4.7 

| 5.0 

i 

i 

(none to be written) 

I 1.0 

1 

| 1.0 
i 

| 1.0 
i 

i 

i 

i 

File Control 

1 

1 

i 

i 

! 

i 

i 

ISAM GET - INQUIRY 

1 

| S. 5 

| 13.5 

1 

| 16.0 

i 

PUT - ADD 

1 - 

| 32.0 

| 32.5 

i 

GET - UPDATE 

i 5.5 

| 14.5 

| 16.0 

i 

PUT - UPDATE 

| 5.4 

| 21.1 

| 25.2 

i 

Cylinder index not 

i 

1 

1 

i 

in core, add 

| +2.0 

| +5.5 

| +5.8 

i 

CICS/VS logging (UPDATE), 


i 

1 

i 

add: 

I +0.2 

| +0.2 

| +0.2 

i 

logging forcing I/O, add 4 : 

I +3.3 

| +7.0 

| +7.5 

i 

Primed storage 

1 

i 

1 

i 

GET (UPDATE) 

| NA 

| -0.4 

| —0.4 

i 

i 

PUT/GET (INQUIRY) 

| NA 

1 

| -0.3 

1 

| -0.3 

a 

1 

i 

BDAM GET - INQUIRY 

| 2.4 

| 3.7 

I 5.30 

i 

PUT - ADD 

| 5.8 

1 5.5 

| 8.8 

i 

GET - UPDATE 

I 3.0 

| 7.4 

| 10.6 

i 

PUT - UPDATE 

| 2.8 

| 4.9 

| 6.5 

i 

Logging (on update) 

| +0.8 

| +0.8 

| +0.8 

i 

Logging forcing I/O, add 4 : 

I +3.3 

| +7.0 

| +7.5 

i 

Primed storage 

1 

1 

1 

i 

UPDATE operations 

| NA 

| -0.3 

I —0.3 

i 

i 

«_ 

INQUIRY 

| NA 

I 

| -0. 1 

1 

| -0.1 

1 


Table 3. (Part 3 of 6) CICS/VS Application Function Timings in 
Milliseconds on the Hypothetical Standard Processor 
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r- 

Application 

Function 

| 7SB | OS/VS1 | OS/VS2 

| (Times in milliseconds) 

~i 

r~ 

VSAM (VSE 

VSAH) (See Note 5) 




T 


KSDS 

GET - INQUIRY 

| 4.9 

| 4.8 

1 6.2 




PUT - ADD 11 

9.0 

| 9.6 

| 10.5 




PUT — mass insert 

|8.9+4.ON 

| — 

| — 




of N records 







GET - UPDATE 

| 5.2 

| 5.0 

| 6.4 




PUT - UPDATE 

3.9 

1 4.1 

| 4.9 




DELETE 

| 10.5 

1 — 

j * 




Each index I/O, 







add 6 : 

| +1,7 

| +2.5 

| +3.7 




Each index level 







other than first level 







or sequence set, add 6 : 

| +1.0 

| +1.0 

| +1.0 




Control interval splits 7 

| 17.0 

1 “ 

1 — 



Primed storage 






UPDATE 

| NA 

| -0.3 

| -0.3 



INQUIRY 

| NA 

| —0.2 

| -0.2 



ESDS 

and REDS 







GET - INQUIRY 

| 3.9 

I 3.8 

I 4.8 




PUT - ADD 11 

| 8.4 

| 8.5 

I 9.7 




GET - UPDATE 

1 4.1 

| 4.2 

1 5.1 




PUT - UPDATE 

| 3.8 

1 4.1 

| 4.9 




BROWSE — N records 

| 9.0 + 







| 3.8N 

| — 

j — 




Logging (KSDS, ESDS, 







REDS) 

| (Use logging pathlengths for 





| 3DAM 

, above) 

■ 




VSAM 

ICIP (0S/VS2 only) 


l 

t 





KSDS GET 

| NA 

| NA 

| 3.5 




PUT 

| NA 

| NA 

| 3.0 




per index I/O 

| NA 

| NA 

| 2.0 




ESDS GET 

| NA 

| NA 

| 3,2 




PUT 

| NA 

| NA 

I 3.0 




VSAM CHECK 

| 0.1 

| 0.1 

| 0.1 




RELEASE 

| 0.2 

| 0.3 

| 0.3 



Temporary Storaae 


i 

1 




Main storage GETQ/GET 

| 0.25 

| 0.25 

| 0.25 




PUTQ/PUT 

| 0.40 

| 0.40 

| 0.40 




PURGE 

| 0.52 

| 0.52 

| 0.52 



Auxiliary 

GETQ/GET (no I/O) 

| 0.15 

1 

| 0.30 

| 0.30 



storage® 

GETQ/GET (I/O) 

I — 

1 3-5 

| 4.6 




PUTQ/PUT (no I/O) 

| 0,28 

| 0.4 

| 0.4 




PUTQ/PUT (I/O) 

I — 

I 3.7 

} 4.8 


L 


PURGE 

| 0.28 

| 0.28 

1 

1 

| 0.28 



Table 3. (Part 4 of 6) CICS/VS Application Function Timings in 
Milliseconds on the Hypothetical Standard Processor 
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r~ 

Application Function 

| VSE | 0S/VS1 | 0S/VS2 

| (Times in milliseconds) 

—1 

r~ 

Transient Data 

1 

i 

1 

—1 


Intrapartition with TSAM 

1 

I 

i 

i 

1 

1 



GET 

| 3*2 

| 4.0 

| 5*0 



POT 

| 3.6 

| 4.4 

1 5.4 



GET/PUT (no I/O) 

| 0*22 

| 0.22 

| 0.22 



First GET 

| 6*0 
i 

| 7.6 

| 9.6 



with BDAM 

i 

i 

i 

i 

1 

1 



GET first item 

| 7.0 

| 6.7 

} 8.7 



GET subsequent 

| 3.2 

| 3.3 

1 4.3 



POT first item 

| 9.0 

| 25.8 

| 29.8 



POT subsequent 

| 3.5 

| 11.4 

| 12.9 



POT to a full track| — 

| 22.0 

| 25.0 



Extrapartition 

i 

i 

i 



GET (no I/O) 

1 — 

1 — 

1 — 



POT (no I/O) 

| 0.33 

| 0.33 

| 0.33 



GET (I/O) 

1 - 

| - 

1 - 



PUT (I/O) 

| 1*6 
i 

| 2.4 

i 

| 3.6 

1 



Intersvstem Communication 

1 

i 

1 

i 

1 

1 



(See Note 12 before using) 

i 

i 

i 

1 

1 



Simple functions: 

1 

i 

i 

i 

1 

1 



Local system with BID 

| 28.6 

| 32.7 

| 38.8 



without BID 

| 17.0 

| 19.4 

| 22.9 



Remote system with BID 

| 27.0 

| 30.4 

| 35.4 



without BID 

| 17.3 

| 19.1 

i 

| 21.7 

| 



Message Performance Option 

1 

i 

i 

i 

1 

1 



Local system 

| 15*5 

| 17.0 

| 21.0 



Remote system 

| 16.5 

| 19.0 

| 

| 22.0 



Update function with 

i 

i 

1 

1 

1 

1 



synchronization: 

i 

1 

1 



Local system with BID 

| 56.9 

| 64.6 

| 76.2 



without BID 

| 45.3 

| 51.3 

| 60.3 



Remote system with BID 

| 54^6 

| 61.7 

| 70.7 



without BID 

| 44.9 

| 50.4 

■ 

| 57.0 

1 



Table search 

1 

1 

1 

i 

i 

1 

1 

| 



Sequential search (N=number of | 

1 

i 

1 

1 



entries searched before the 

1 

i 

1 



current entry is found) 

1 

i 

1 



DFHDCT 

1 

i 

1 



intrapartition entries 

| 0.009 

| 0.009 

| 0.009 



extrapartition entries 

| 0.007 

| 0.007 

| 0.007 



DFHFCT 

| 0.004 

| 0.004 

| 0.004 



DFHPCT 

| 0.006 

| 0.006 

| 0.006 



DFHPPT 

| 0.006 

| 0 i 006 

1 

i 0.006 

a 



Indexed search 

i 

i 

1 

I 

I 

i 



All tables 

i 

1 

i 



If number of entries is 

i 

1 

i 


L. 

between 2»-1 and 2N 

| 0.013N 

| 0.013N 

| 0.013M 

; 


Table 3. (Part 5 of 6) CICS/VS Application Function Timings in 
Billiseconds on the Hypothetical Standard Processor 
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I 


I 


Appiication Function 


VS B | 0S/VS4 t &S/V52 

(Times in milliseconds) 


Trace per call 

| 0.06 

| 0.06 

| 0.06 

or as a percentage of 
total pathlength 

1 

| 15% 

1 

1 

I 13* 

1 

| 10* 

I 

Paae Faults (that cause I/O) 

1 

1 

I 

1 

1 

1 

1 

1 

I 

Average values are: 

1 1*5 

■ 

I 2.5 

1 

| 3.0 

| 

Miscellaneous 

1 

1 

| 

1 

1 

| 

1 

1 

1 

Job accounting (VSE only) 

HTS system resource manager — 

| +7% 

1 

1 

| NA 
i 

1 

| NA 

1 

approximately per address space per | 

i 


cycle: 

| NA 

| NA 

| 1.5 


Table 3. (Part 6 of 6) CICS/VS Application Function Timings in 
Milliseconds on the Hypothetical Standard Processor 


Notes: 

1. A VPACING RESPONSE can usually be prorated across several WRITES; 
for example, if there is a pacing response sent on every third 
WRITE, 2.8/3 (0.93) must be added to each transaction. 

2. These READS and WRITES are additional to those included in ECHO 
paths. VTAM options will not always be the same as those used in 
the ECHO. 

3. If STARTIO=NO is used, and N is the average number of records in 
the block, 

(N-1/N) X (1/N) x STARTIO=YBS 

should be used. The PUT plus STARTIO=NO times include the 
execution of the timer SVC. 

4. A significant amount of processing is done at a sync point (often 
at the end of a task). A value of 4.0 milliseconds should be 
added, but this can be prorated across the number of updates 
between sync points. If I/O is forced because the buffer shift—up 
value is exceeded, the ST A RT10 =YE S values should be used instead. 

5. If FASTTR=YES is specified, CICS/DOS/VS VSAM pathlengths may be 
reduced by up to 0.9 milliseconds per physical I/O, depending on 
the proportion of CCWs that do not have to be translated. 

6. The VSAM KSDS times assume that each data set has a top-level index 
and a sequence set index. They also assume that no index I/Os take 
place (only the data I/O). Values are given to take account of 
index I/Os and additional index levels. These values should be 
added, as appropriate, to tne GET (INQUIRY and UPDATE), PUT (ADD), 
and DELETE values, but not to PUT (UPDATE). For example, if an 
0S/VS1 data set has 3 levels of index (two + sequence set) and only 
sufficient buffers allocated to keep the top level in core, the 
time for a GET (INQUIRY) would be: 

4*8 + 2 x 1.0 + 2 x 2.5 
= 11.8 milliseconds 
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The values for additional indexes may vary considerably depending 
on the number of records in the control interval and on the 
position of the index required in the control interval* Variations 
from 0*5 milliseconds to 2.0 milliseconds can be expected* 

7* The control interval split values are approximate. Considerable 
variation can be expected. 

8. I/O only occurs when the VSAM control interval becomes full (POT), 
or when a new control interval is read in (GET). To obtain an 
average path with records per control interval, 

(N—1/N) x no I/O timing + (1/N) x I/O timing 

should be used. 

9. Where a BMS SEND command is followed by a BMS RECEIVE without an 
intervening WAIT, a further 2 milliseconds should be added. 

10* The 11*0 milliseconds addition makes an allowance for the loading 
of the RPG II program. For large programs (more than 12K bytes) 
this value may need to be increased. Sub—programs that are called 
will always be loaded and allowance should be made for these by 
using the program control program data. For medium—sized programs 
(between approximately 4K and 12K bytes) two loads should be 
allowed for* 

11. PUT/ADD assumes that the control interval must be read in before 
data can be entered. This will not always be necessary if, for 
example, the control interval is in core from a previous operation. 

12* The intersystem communication (ISC) facilities allow the user to 
access resources on a remote system using file control, transient 
data, temporary storage, DL/I, and interval control. The processor 
times necessary to execute these functions on a remote system can 
be calculated as a sum of several times on both the local system 
and the remote system. 

The times on the remote system are the times taken to: 

a. Execute the requested function at the macro level, and 

b. Execute the ISC code on the remote system* 

The times on the local system are the times taken to: 

c. Execute the additional code necessary to perform the function 
at the command level 
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d. Execute the ISC code on the local system. 

Items a. and c* can be found elsewhere in this table. The BID 
times should be used when the system that initiates the request has 
to BID for the reguest. 

“Simple” implies a simple one-command function (for example, a file 
control GET) where no synchronization is necessary. For an 
"update 11 type of operation, synchronization is usually necessary. 
This is included in the times. Note that for an update operation, 
the times under "update operation include the ISC overhead for both 
the GET and PUT parts of the operation. 

| For ftVS and VTAM authorized path, the VSE figures should be used 

and increased by 5%. 

With the Message Performance Option (MPO) there are no BID reguests 
sent to obtain the link, and the only reguest that may be shipped 
is START. 

With support for parallel sessions, it should normally be 
unnecessary to BID for a session, as all sessions can be allocated 
by a secondary. 


TABLE 4. 


System/370 Processor Relative Power 
Model Facto r 


1 

115 

50 

1 

115—2 

85 

1 

125 

85 

1 1 

125-2 

115 

1 1 

135 

180 

1 1 

138 

225 

1 

145 

350 

1 

148 

430 

1 

155-2 

600 

1 1 

158 

850 

1 

158-3 

9 50 

1 

Hypothetical standard 


1 

processor (see Note 3) 

1000 

1 

3031 

1100 

1 

168 

2100 

1 

168-3 

2400 

1 

3032 

2500 

1 

3033 

4400 

1 

4331 

200 

1 1 

1_ 

4341 

700 


Table 4* Approximate Relative Power Factors for Dedicated 
CICS/VS Systems 


Notes : 

| 1. The values for the 4331, 4341, 3031, 3032, and 3033 have not been 

measured in a dedicated CICS/VS environment and only represent a 
very rough estimate for guidance only. Possible errors are (plus 
or minus) 10%. 
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2. The figures given do not account for the impact of the microcode 
assist feature that is available on some processors and they will 
generally give a pessimistic result if the assist feature is used. 
& conservative estimate of the improvements is 10% in a dedicated 
CICS/VS environment. 

3. The hypothetical standard processor's relative processing power is 

1000. 

| 4. The relative processing power of 4331 and 4341 should be viewed as 

| figures for DOS/VS. They should be modified for other operating 

| systems by the following multiplying factors: 


1 

0S/VS1 

0.87 

1 

0S/VS1 ECPS 

1.08 

1 

VSE 

1.11 

1 

VSE ECPS 

1.18 



I | | VSE | OS/VS1 | OS/VS2 (MVS) 


CICS/VS 1.3 


1 


V 

1 0.2 | 

0.2 | 

0.2 

X 

1 1.0 | 

3.0 | 

5.4 

Y 

| 0.04 | 

0.04 | 

0.04 

z 

| 0.07 | 

t I 

0.07 | 

0.07 

CICS/VS 1.4 

1 1 

1 1 

1 

1 


V 

1 0.2 | 

0.2 | 

0.2 

X 

i 1*0 | 

3.0 | 

5.4 

Y 

| 0.05 | 

0.05 | 

0.05 

Z 

1 0.2 | 

1 1 

0.2 | 

1 

0.2 



Table 5. CICS/VS Background Timings (in milliseconds) 
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Chapter 8.3. Virtual Storage 


In order to run the system efficiently, the system programmer needs to 
be able to estimate the virtual storage requirements. If insufficient 
virtual storage is allocated, the system will either not function or it 
will suffer degraded performance. If the virtual storage requirements 
are grossly overestimated, performance will also suffer. Fortunately, 
the estimation does not need to be too accurate. In general, the system 
programmer needs to be able to calculate the virtual storage 
requirements to an accuracy of about 25% of the real storage size. For 
example, if a CICS/DOS/VS system with VSAM and VTAM were running on a 
370/145 with 512K bytes of real storage, the virtual storage allocated 
would probably be approximately 2.5 megabytes, and the system programmer 
should be able to gauge his virtual storage requirements to the nearest 
128K bytes. Calculation in greater detail is wasted effort. 

Virtual storage requirements are divided into four areas. These are: 

• Non—CICS/VS requirements, which include the operating system, major 
access methods, and work areas. These requirements exclude 
anything contained in the CICS/VS partition or region. 

• Static CICS/VS areas, that is, requirements for CICS/VS modules and 
tables storage which do not depend on the transaction rate. 

• Dynamic requirements of CICS/VS and major access methods which vary 
with the amount of traffic in the system. 

• Application programs and data area spacer 

Figures 8.3—1, and 8^3—2 at the end of this chapter show the general 
disposition of storage for CICS/DOS/VS and ClCS/OS/VS. Figure 8.3—3 
provides data that may be used to calculate the OSCOR size in 
CICS/OS/VS. 

These virtual storage areas are discussed in the sections that 
follow. 

In addition, the chapter also contains three tables of data: 

• Table 6 provides information on operating system requirements. 

• Table 7 gives the sizes of the CICS/VS modules and tables. 

• Table 8 gives the sizes of infrequently used CICS/VS modules. 


OPERATING SYSTEft AND MAJOR ACCESS KETHOD REQUIREMENTS 


The appropriate manuals give detailed virtual storage estimates for the 
operating systems and major access methods. These estimates should be 
used when making detailed calculations, especially when other programs 
besides CICS/VS are being run on the same machine. 

The figures given below are for illustrative purposes only and 
represent only a small number of possible cases. Variations on these 
numbers will occur, depending on the options selected. 
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I 


Minimum system + 3TAM/IS AM/DAM 
System with BTAM/VSAM 
System with VTAM/ISAM/DAM 
System with VTAM/VSAM/ISAM 


Tanle 6. 


but excluding CICS/VS 


YSS 

0S/VS1 

200K bytes 

1.0M bytes 

512K bytes 

1.5M bytes 

1200K bytes 

2.2H bytes 

1600K bytes 

3.OH bytes 

irements including 

major access methods 


STATIC CICS/VS AREA REQUIREMENTS 


The virtual storage requirements given below are for CICS/VS nucleus 
modules and control blocks, which are normally resident in virtual 
storage and are included in the CICS/VS partition or region. For 
CICS/DOS/VS/ certain non-CICS/VS areas are included in the partition 
because they are included in CICS/VS modules or tables. For OS/VS and 
| VSE/ CICS/VS gives part of its region*s storage back to the operating 
system. This is known as OSCOR (for OS/VS) and is discussed below. 

This section does not discuss areas which are allocated in the 
CICS/VS dynamic storage area. 


CICS/VS MODULES 


The storage requirements can be obtained by summing the sizes of all the 
CICS/VS modules to be used. An allowance should be made for the 
packaging of the various modules/ and hence some module sizes should be 
rounded up to the next page boundary. A knowledge of the nucleus load 
table layout is reguired. Alternatively/ the size of each module or 
table can be rounded up to the next page boundary. In addition to 
CICS/VS requirements/ the sizes of all resident application programs/ 
control blocks and maps should be added. 

Table 7 (below) gives the sizes of CICS/VS modules, with variations 
f for major options for both VSE and OS/VS. 
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r- 

1 

CTCS/VS Module 

| VS^B 

I Od/VS 

i 

r 

DFHCSA 

including default 512 

i 

i 


T 



bytes user area 

| 4258 

| 

| 4624 



DFhKCP 

(Task Control) 

| 7000 

1 

| 8160 



DFHSPP 

(Sync Point) 

| 2720 

1 

| 2744 



DFHSCP 

(Storage Control) 

| 6400 

| 6944 




Recovery^!es 

| +3138 

| 3160 




Add size in bytes of the DSA in K bytes 

1 *1 

1 

1 x 2 



DFHPCP 

(Program Control) 

1 





Assembler only 

| 3000 

| 3700 




Assembler, PL/I, and RPG II (VSE) 

| 4328 

| 4200 




Assembler, COBOL, and RPG 11 (VSE) 

| 5466 

| 6100 




All support 

| 5740 

i 

| 6568 



DFHTCP 

(Terminal Control non—VTAH) 

1 

i 





BASE 

| 3200 

| 3600 




Sequential support 

| +1000 

| +700 




Console support 

1 — 

1 N/A 




TCAH support 

1 N/A 

1 

| +3000 




Automatic initiation 

| +140 

| +160 




BTAM support 

1 





Start/Stop non switched 

1 0 

1 o 




Plus Autopoll and Wraplist 

| +650 

| +270 




Switched 

| +450 

| +430 




Translate tables 2740/2741E/Sys/7 

| +520 

| +520 




Correspondence 2741C 

| +290 

| +290 




Text Mode Correspondence 2741CM 

| +260 

| +260 




Text Mode EBCDIC 2741BM 

1 

1 





BTAM BSC — any device 

l +2080 

| +520 




Non switched 

| +840 

| +800 




Switched 

| +1300 

| +1200 




Translate table ASCII 

| +520 

| 

| +520 




1050 Translate Table 

| +520 

| +520 




Switched support 

| +560 

| +480 




Non switched 

| +580 

| 

| +550 




2260 Base 

| +720 

| +570 




Local 

| +590 

| +590 




Remote 

| +9 20 

| 

| +850 




2740 Switched 

| +580 

| +510 




Non switched 

| +590 

| +540 




Model 2 with Buffer Receive 

| +320 

| +320 




2741 Switched 

| +500 

| +460 




Non switched 

| +320 

| +300 




Other features 

| +360 

i 

| +460 




2770 Switched 

I 

| +300 

| +300 


L. 


Non switched 

| +340 

| +340 

—1 


Table 7. (Part 1 of 4) CICS/VS Module Sizes in Bytes 
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> 


2780 Switched 

i 

| +300 

1 

| +300 

■ 



Non switched 

| +360 

| +360 




2980 Common 

| +2400 

| +2400 




Model 1 

| +330 

I +330 




Model 2 

| +330 

| +330 




Model 4 

| +350 

| +350 




TBLFIX=TES 

| +3850 

| +3850 
| 




3270 Support (BTAM) 

| +1100 

1 

| +900 

1 




Local 

| +1730 

| +1730 




Remote 

| +3300 

| +3300 




Upper Case Translation EBCDIC 

| +320 

| +320 




Upper Case Translation ASCII 

| +280 

1 

| +280 

1 




3270 Compatibility — Basic 

| +4000 

1 

| +4000 




Additional features 

| +220 

| +220 




3735 Dial 

1 

1 

| +1430 




3740 

| +350 

| +350 




Switched 

| +1450 

| +1450 




Leased 

| +1200 

1 

| +1200 

1 




3780 Switched 

| +300 

| +300 




Leased 

| +340 

• 

| +340 




7770 

1 

1 

1 




CONVTAB = ABB 

I +330 

| +330 




CONVTAB = ABC 

| +280 

I 

| +280 
■ 




System/7 

| +200 

| +200 




Switched 

| +1000 

| +1000 




Non Switched 

| +860 

1 

| +860 
* 




TLX 

| +1270 

| +1270 




TWX 

| +9 40 

I 

| +940 

■ 



DPHZCP 

(BTAM/VTAM Terminal Control) 

1 

1 

I 

1 




DFHZCP working set (BTAM only) 

| 1150 

| 1150 




working set (3270 only) 

| 4384 

| 4000 




working set (all support) 

| 5180 

| 4784 




DFHZCA working set (VTAM only) 

| 4256 

t 3648 




DFHZCB working set (VTAM 3270) 

| 10900 

| 10900 




working set (all support) 

| 13800 

| 13976 




DFHZCX non—working set (BTAM only) 

| 916 

| 916 




non—working set (VTAM 3270 only) 

| 2280 

| 2280 




non—working set (all support) 

| 5000 

| 6864 




DFHZCY non—working set (VTAM only) 

| 8264 

| 9560 




DFHZCZ non-worKing set (VTAM 3270) 

| 4616 

| 4400 




non—working set (VTAM all) 

| 6424 

1 

| 6112 

1 



DFHICP 

(Interval Control) 

| 3212 

1 

| 3040 

1 


L. 

DFHSDAM (DAM logic module) 

| 1900 

| NA 

J 


Table 7. (Part 2 of 4) CICS/VS Module Sizes in Bytes 
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1 CICS/VS 

Module 


1 111 

1 OS/VS 

i 

1 

| DFHSRP 

(System Recovery) 


| 2044 

| 4351 


| DFHFCP 

(File Control) — VSE only 






VSAM 


| 5452 

| NA 



+ automatic 

journaling 

| 6980 

| NA 



ISAfl+DAM 


| 5808 

| NA 



+ automatic 

journaling 

| 6876 

| NA 



DAM+VSAM 


| 7344 

| NA 



+ automatic 

journaling 

| 8872 

| NA 



VSAM+ISAM 


| 8156 

| NA 



+ automatic 

journaling 

| 9764 

| NA 



VSAM+ISAM+DAM 


| 9168 

| NA 



+ automatic 

journaling 

| 10816 

| NA 



ISAM 


| 3832 

| NA 



+ automatic 

journaling 

| 4784 

| NA 



DAM 


| 4820 

| NA 



+ automatic 

journaling 

| 5764 

| NA 



Indirect access, input, 

and output 





segmenting, add 


| +1700 

| NA 


| DFHFCP 

- OS/VS only 


| NA 




Common 


| NA 




VSAM Common 


| NA 




VSAM non—IClP 


| NA 




VSAM ICIP 


| NA 

| +2048 



BDAM Support 


| NA 




ISAM Support 


| NA 




Automatic Journaling 


| NA 

| +840 



Maximum Size 


| NA 

| 11064 


| DFHFCD 

(ISAM/BDAM only) 






Common 


| NA 

1 — 



BDAM 


| NA 

1 — 



ISAM 


| NA 

| — 



Maximum Size 


| NA 

| 3832 


| DFHTDP 

(Transient Data) 






Base + EXTRAPARTITION 


| 630 

| 504 



plus INTRAPARTITION 


| 3000 

| 3800 



plus Recovery 


| 5066 

| 5512 


| DFHTSP 

(Temporary Storage) 






Base (AUX=NO) 


| 2702 

| 2856 



AUX=YES 


| 4928 

| 5200 



AUX=REC 


| 7178 

| 7280 


| DFHTRP 

(Trace Control) 






AUX=YES 


| 8692 

| 7768 



AUX=NO 


| 2416 

| 2552 


| DFHDCP 

(Dump Control) DISK (approx.) 

| 14000 

| 14000 


■ 

TAPE 


| 35932 

| 35848 



Table 7. (Part 3 of 4) CICS/VS Module Sizes in Bytes 
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i cics/vs 

Module 

I VSE 

i 

-1 

OS/VS 1 

F 

| DFHJCP 

(Journal Control) 

i 

I 3756 

i 

i 

i 

1 " '1 

4008 | 

| DFHEIP 

(EXEC Interface Program) 

Base module DFHEIP 

Other modules (all support) 

1 

| 4500 

| 6500 

■ 

• 

i 

i 

i 

i 

3592 | 

8000 | 

| DFHDIP 

(Batch Data Interchange program) 

| 3344 

1 

1 

1 

i 

3416 | 

| DFHISP 

(Intersystem Communication program) 

| 1034 

1 

1 

i 

i 

728 | 

| DFHMIR 

(ISC Mirror program) 

| 692 

| 

1 

i 

i 

712 | 

| DFHXFP 

(Function Shipping Transformer program) 

1 

1 

| 

1 

i 

i 


| DFHXTP 

(Transaction Routing Transformer 
program) 

1 

1 

1 

1 

1 

i 

a 


| DFHXSP 

(Security management program) 

| 736 

i 

1 

i 

1 

880 | 

| DFHCRP 

i- 

(Transacation Routing Relay program) 

1 

1 

i 

_i 


Table 7. (Part 4 of 4) CICS/VS Module Sizes in bytes. 


BASIC MAPPING SUPPORT 

The following modules can be generated: 

DFHMCP Control Program 
DFHPBP Page Build 
DFHIIP Non 3270 
DFHTPP Terminal Page Program 
DFHM32 3270 Mapping 
DFHDSB Data Stream Builder 
DFHRLR Route list resolution 
DFHTPQ Terminal Page Clean up 
DFHTPR Terminal Page Retrieval 
DFHTPS Terminal Page Scheduling 
DFHFIP Faster 2260 
DFHF2P Faster 2260 
DFHBMSMM Pre-VS module 

Total virtual storage space requirements (assuming that the modules 
are resident and packed end—to—end) are given for a few different sets 
of BMS processing options. 


Minimum 3270 Mapping 

Minimum 3270 mapping + sequential devices 
Minimum 3600 mapping + sequential devices 
Default 3270 mapping 

Default 3270, 3600, 2740, 2770 mapping 

Default 3270, 3600, 2740, 2770 mapping + Paging and Routing 


6K bytes 
16K bytes 
14K bytes 
16K bytes 
23K bytes 
3OK bytes 


These numbers will allow the user to gain an approximation to his 
actual sizes. This should be ample information to allow a calculation 
of sufficient accuracy to be made for the virtual storage requirements. 
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The remaining CICS/VS programs are defined in the DFBPPT and can 
either be resident or non-resident in main storage. If they are 
resident, virtual storage should be allocated. If non-resident, space 
need not be allocated for all programs because they will not all be used 
concurrently. However, for reasons of efficiency, it is suggested that 
those programs used during on-line operation (that is, not at 
initialization or during shutdown) should be allocated space. The sizes 
| given are maximums and are, for the most part, the same for VSB and 


OS/VS. Where they 

differ. 

the larger is given. 


PROGRAM NAME 

SIZE 

PROGRAM NAME 

SIZE 

DFHACP 

5704 

DFHP3270 

1104 

DFHAKP 

704 

DFHPRK 

440 

DFHAQP 

240 

DFHRD1 

1944 

DFHATP 

3656 

DFHRD2 

752 

DFHBMSMfl 

1904 

DFHRKB 

116 

| DFHCPY 

296 

DFHRTE 


| DFHCRQ 


DFHRUP 

799 2 

| DFHCRS 


DFHSFP 

344 

DFBCWTO 

1656 

DFHSNP 

2544 

DFHDBP (for DL/I) 

7890 

DFHSTKC 

6224 

DFHEXI 

176 

DFHSTLK 

2212 

DFHFEP 

4912 

DFHSTP 

3584 

DFHJCBSP 

424 

DFHSTPD 

2176 

DFHJCC 

308 

DFHSTSP 

6528 

DFBJCEOV 

464 

DFHSTTD 

3164 

DFHJCI 

1048 

DFHSTTR 

5392 

DFHJCIOE 

616 

DFHTACP 

5568 

DFHJCJFP 

920 

DFHTAJP 

696 

DFHJCKOJ 

660 

DFHTBP 

10794 

DFHJCO 

2700 

DFHTDRP 

2336 

DFHJCOCP 

2000 

DFHTEP 

40 

DFHJCSDJ 

4 72 

DFHTEPT 

— 

DFHMSP 

10936 

DFHTPQ 

2484 

DFHMTPA 

10336 

DFHTPR 

11552 

DFHMTPB 

10760 

DFHTPS 

40 

DFMMTPC 

10920 

DFHTSRP 

3280 

DFHMTPD 

9312 

DFHUAKP 

— 

DFHMTPE 

9216 

DFHWT1 

2848 

DFHMTPF 

10944 

DFHWT2 

1816 

DFHMTPG 

9784 

DFHZNAC 

10800 

DFHOCP 

3680 

DFHZNEP 

56 

DFHPEP 

48 

DFHZRLG 

360 

DFHPLP 

152 

DFHZRSP 

560 


Table 8. Sizes of Infrequently Used CICS/VS Modules 


CICS/VS TABLE SIZES 


The sizes of CICS/VS tables and static control blocks depend on the 
number of entries in the various tables* The virtual storage 
requirements should include space for all entries, together with an 
allowance for expansion as more devices, data sets or programs are added 
to the system. Tables which are used during system initialization and 
then overwritten are not included in these estimates. 

The sizes of the various tables given below should be rounded up as 
necessary to the next page size unless the tables are packed close to 
other modules or tables. The nucleus load table in use (default or 
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user-supplied) should be used to assist in the mapping of these tables. 
In all the tables below, ”E” is the number of entries, "C” is the table 
header or constant value, and ”R” is the number of remote entries (for 
use with connected systems). 


PROGRAM CONTROL (DFHPCT) 

| Size=C + 84E + 100R 

For the sequential scan routine, C=160 bytes, and for the index scan 
C=176 bytes. In addition, when the INDEX option is used, an additional 
| 6 bytes per identifier should be allowed for the index table. E should 
include the CICS/VS service programs, a list of which is given in 
Appendix A under "Program Control Table”. 


PROCESSING PROGRAM TABLE (DFHPPT) 

Size=C + 40E + 52CE for OS/VS 

| Size=C + 56E + 68CE for VSE 

where: ”C” is 160 bytes* If PAGBNXD=YES is used, ”C f, = 176 bytes and an 
additional 10 bytes per entry is reguired for the index table. 

”E” is the number of assembler, PL/I, and RPG II entries. "CE" is the 
number of COBOL entries. 

DESTINATION CONTROL (DFHDCT) 

Size=140 + (El + E2 + ...E n ) + AM 

where ”E n ” are the sizes of each entry (see the table below) and "AM” is 
the total number of bytes required for access methods when using 
| CICS/DOS/VS. The sizes of the VSE access method modules can be found in 
| the VSE/Advan c ed Functi o ns System Generation manual for the appropriate 
I release. If INDEX=YES is used, add 6 bytes for each entry. 


E ntry Sizes 

TYPE=INTRA 84 bytes 

TYPE=EXTRA 16 bytes 

TYPE=INDIRECT 16 bytes 

TYPE=REMOTE 24 bytes 

To the above, add the following as appropriate for TYPE=SDSCI (1 per 
physical data set): 



VSE 

OS/VS 

Automatic OPEN, BUFNP=n 

nxB 

Note 1 

Printer 

60 

96 

Disk — Fixed input 

140 

96 

— Fixed output 

172 

96 

— Variable output 

18 0 

96 

Tape — Standard labels 

16 

96 

— Fixed records 

100 

96 

— Variable records 

112 

96 


I Note 1 : B=buffer length for VSE. For OS/VS, although the storage is 
not part of the table, it must be given back to OS/VS as part of OSCOR. 
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TEMPORARY STORAGE (DFHTSUT) 

a) DFHTSUT Size =32+32E 

b) Temporary storage data set control information size = 272 + M bytes 
where H= the number of control intervals in the temporary storage 
data set. 

c) Two buffers (each to accommodate the VSAM control interval size). 
TRACE CONTROL (DFHTRT) 

Size=58+16E 


SYSTEM RECOVERY (DFHSRT) 

Size=1300+16E 


TERMINAL CONTROL 

(DFHTCT ) 



PREFIX 


740 

bytes 



VSE 

OS/VS 

TYPB=SDSCI 

Card Reader/Printer/Tape 

54 

36 


Disk 

152 

152 


2741C/274IE 

152 

36 

TIPE=LINB 

(not VTAM) 

88 

88 


POOLADR= 

+4 

+4 


Device=BSC device 

+40 

+40 

TYPE=TBRMINAL 

Start/Stop 

228 

228 


BSC including 3270 

240 

240 


VTAM terminals 

396 

396 


VTAM 3270 

4 08 

408 


For each remotely owned terminal 

20 

20 


For each different type of 
remotely owned terminal 

As for 

TYPE=TERMINAL 

VTAM Support 

Exit routines, ACB etc 

4000 

4000 

DTFs/DCBs 


184 

96 

Sequential disJc logic 

1000 

NA 

RAPOOL 

Each VTAM fixed RPL 

112 

112 

Each VTAM NIB 

(1 per logical unit) 

64 

64 


| BTMOD for VSE only 

| (see the VSB/Advanced Functions System Generation manual) 
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FILE CONTROL (DFHFCT) 

I VSE Size=100 + 160V + 280B + 7001 + ISMOD + EXCPAD + II 

OS/VS Size=100 + 172V + 140B + 2881 + II 

where "V", "B» and M I ,f are the number of VSAM, BDAM and ISAM files; "II" 
is the ISAM resident index area size; ”EXCPAD» is the VSAM exit routine 
size (=180 bytes) and "ISMOD" is the ISAM logic module. See the 
I VSE/Ad v anced F unctions System Generation manual for the exact size. 5K 
bytes may be taken as an approximate value. 

JOURNAL CONTROL (DFHJCT) 

OS/VS Size=50+268E 

| VSE Size=164E + 16 + 152SD + 48MT + SDMOD + MTMOD 

where SD = number of DTFSDs, and MT = number of DFTMTs• See the 
I V SE/Advanced Functions System Generation manual for the sizes of SDMOD 
and MTMOD. 

SIGN-ON (DFHSNT) 

Size=36E 


PROGRAM LIST (DFHPLT) 

Size=8E 


TRANSACTION LIST (DFHXLT) 

Size=4E 


CICS/VS DYNAMIC STO RA GE AREA 


The object of this stage is to decide how much virtual storage is 
required for the dynamic storage area so that, under normal operating 
conditions, the short-on—storage condition will only appear in error 
situations (for example, when application programs do not free storage). 
Obviously, this can be done by allocating excessive amounts of virtual 
storage to the partition or region. It is, however, preferable to 
estimate the requirements and use this as a starting point for tuning 
the system. 

The requirements may be divided into the following sections: 

• Storage for non-resident CICS/VS and application programs and maps 

• Working storage used during the execution of application programs 

• Storage cushion 

• Temporary storage 

• VSAM buffer storage. 

| • OSCOR (OS/VS only) or the VSE GBTVIS area 

These items are discussed below. 
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PROGRAM STORAGE 


Under normal circumstances most of the programs and maps in common use 
will be resident in main storage* Space must be allowed in the DSA for 
the maximum number of the remaining programs and maps which are lively 
to be resident in main storage at any one time. The size of each 
program should be rounded up to the next page size (2K or 4K bytes) when 
making this calculation. 


WORKING STORAGE 


The average virtual storage per transaction is calculated- This should 
be multiplied by the maximum number of transactions which can exist 
concurrently (MXT) to give the total working storage. 

CICS/VS allocates storage into a number of subpools to separate 
different types of usage in a logical manner. There are eight subpools 
(including the program storage subpool described above). Most programs 
will normally use either three or four subpools, depending on whether 
BTAM or VTAM is the access method being used. To avoid unnecessarily 
detailed calculations, 6K bytes (8K bytes if VTAM) should be allowed for 
each task as a basic requirement. In addition, any requirement for 
large FIOAs (file input/output areas), LIOAs (BTAM line input/output 
areas) and TIOAs (terminal input/output areas) should be added. These 
should be estimated on the basis of the lengths of data (records or 
messages) input to or output from the program. In addition, an 
allowance should be made for any application program use of CICS/VS 
storage management GETMAIN requests. 

It should be emphasized that while this approach is approximate, it 
should be adequate for virtual storage calculations. 


STORAGE CUSHION 


This area of storage is only used by CICS/VS if it runs out of virtual 
| storage. If this area is used then either "errors" have occurred or the 
virtual storage allocation for the CICS/VS partition or region was too 
small. 

The size of the storage cushion should be about four pages larger 
than the largest non-resident program or map* 


TEMPORARY STORAGE 


CICS/VS temporary storage uses either VSAM or main storage to store the 
user*s data. If VSAM is used, space equivalent to two VSAM control 
intervals should be allowed. If main storage is used, the product of 
the maximum number of entries and the average entry size should be used. 
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VSAM BUFFER STORAGE 


Although VSAM buffers are not strictly part of the dynamic storage area 
(unlike ISAM and BDAM FIOAs) it is convenient to discuss their 
| requirements at this stage* In VSE, the GETVIS area is used, while for 
OS/VS, OSCOR is used (see below). 

For each file allow 10K bytes for VSAM control blocks. If the index 
control interval size is ICI and the data control interval size is DCI, 
the minimum virtual storage required per file is: 

DCI (1+STRNO) + ICI x STRNO 

rounded to the next page size* This size will be increased if extra 
buffers are allocated. 

If VSAM shared resources are used, the total will depend on the total 
number of control intervals requested multiplied by the control interval 
size. 


OSCOR DEFINITION 


The address space referenced as OSCOR is that storage available to the 
OS/VS operating system to perform partition—related services in response 
to an operating macro or SVC issued by the partition. The operating 
system will use this area to build control blocks or for use as work 
areas. 

The CICS/VS system initialization program (SIP) will ensure that the 
amount of storage specified in the OSCOR parameter is returned to the 
operating system. 

The reason this parameter is necessary in a CICS/VS system is that 
CICS/VS will acquire and manage all remaining storage in the partition 
that remains after the CICS/VS nucleus, tables, and resident programs 
have been loaded. 

Because of the dynamic nature of a CICS/VS system, the demands on 
OSCOR will vary during the day, that is, as the number of tasks 
increases or data sets are opened and closed. Also, because of this 
dynamic use of OSCOR, fragmentation will occur so that additional 
storage must be allocated. 

During initialization, CICS/VS will only open data sets that the user 
requests. The control blocks that are built at open time are allocated 
within the CICS/VS partition and do not place a requirement on OSCOR. 

The OSCOR requirements for these data sets are control blocks built for 
the duration of the I/O event and any buffers required. 

If a data set is opened after CICS/VS initialization, the control 
blocks built at open time will be allocated from OSCOR. 

It is assumed that access methods are resident in the OS/VS 
supervisor and will not be loaded into OSCOR. 

Figure 8.3—3 (below) gives values applicable to 0S/VS1* Values for 
0S/VS2 may be taken as approximately the same. It is recommended that 
the total calculated for a region is increased by about 25* to make 
allowance for fragmentation. 
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APPLICATION PROGRAMS 


The user should know the sizes of all application programs and data 
areas. An allowance should he made for all programs that can possibly 
reside concurrently in main storage, irrespective of whether they are 
marked in the PPT as resident or non-resident. In the case of RPG II 
programs, an allowance should be made for several copies, because the 
RPG II object code is not reentrant. 


PARTITION SAVE AREA AND LABEL AREA 

FREQUENTLY USED 

CICS/VS 

NUCLEUS PROGRAMS 

'LOW' RESIDENT APPLICATION PROGRAMS 

TS/TD ALLOCATION MAPS 

PAM 

DYNAMIC 

STORAGE 

AREA 

'HIGH' 

RESIDENT 

APPLICATION 

PROGRAMS 

INFREQUENTLY USED CICS/VS 

NUCLEUS PROGRAMS 

INITIALIZATION COPY OF CSA AND SIT 

j SIP OVERRIDES 

PROGRAM LOADER SUBTASK 

BLDL SUBROUTINE 

DFHWTO SUBROUTINE 

GETVIS AREA 


Figure 8.3—1. Storage Organization for CICS/DOS/VS 
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Low 

Storage 


Dummy CSA 


OS/VS Free/Allocated Storage 


PAM 


Dynamic 

Storage 

Area 


The PAM will exist 
either above or below 
the dynamic storage 
area. 


PAM 


TS/TD Allocation Maps 


Resident Application Programs 


Temporary Storage Control Interval Buffers 


OS/VS Free/AHocated Storage 
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Figure 8.3—2. Storage Organization for CICS/OS/VS 
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I- 

I Function I OSCOR Size in bytes 



BTAM 



1 



per 

local line group 

| 300 



per 

local line 

| 140 



per 

remote line 

| 18 4 

ft 


VTAtt 



1 

1 



per 

concurrent OPNDST and CLSDST 

| 1000 



Pageable buffers 

| Buffer size 

I 


BSAW 



1 



per 

data set 

| 220 


QSAM 

Extrapartition transient data 

i 

1 



per 

data set 

| 200 



per 

buffer 

| 16+blksize 

ft 


ISAM 



1 

| index size 



per 

data set 

| 100+blksize 



per 

outstanding I/O reguest 

| 100 
i 


VSAM 



i 



per 

data set 

| 4000 



per 

data set (approx.) 

| 500 X STRHO 



per 

data set (ESDS or KSDS) 

| BtJFHD x data CISIZB 



per 

KSDS data set 

| BOFHI x index CISIZB 

i 


BISAM 


1 

1 



per 

data set (approx.) 

| 1000 



per 

buffer 

j Blksize+16 
■ 


BDAM 



1 

1 



per 

data set (approx.) 

| 400 


Figure 8.3—3. Calculating the OSCOR Size 
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Chapter 8.4. Real or Reference Set Storage Requirements 


It is essential to be able to estimate the amount of real storage 
required by a CICS/VS system. Excessive paging (caused by a heavy over- 
committment of real storage) is a common cause of performance problems. 
It is recommended that, under normal, steady state, error—free 
conditions, a system should execute without page—faults in order to 
minimize response times and to maximize throughput. The amount of 
storage required is usually referred to as the working set or the 
reference set. 


In a normal system, error and exception conditions, together with 
fluctuations in the workload, will occur, which may cause page—faults. 
However, provided this only occurs for short periods, the overall 
efficiency of the system will not be significantly affected. 

The reference set is discussed in terms of: 

• Operating system requirements 

• The major access methods and other components used by CICS/VS 

• CICS/VS 

The discussions of the first two items are brief because more 
detailed information can be found in the appropriate operating system 
and access method publications. 

The chapter contains three tables, which provide information on VTAH 
and VSAM reference set sizes, and Figures 8.4—1 and 8.4—2, which give 
reference set sizes for CICS/DOS/VS and CICS/OS/VS. 


| THE OPERATING SYSTEMS - VSE, 0S/VS1, ANj) 0S/VS2 (MVS) 


| Storage requirements for operating systems and access methods will vary 
| according to the options selected. Detailed figures may be obtained 
| from the appropriate operating system manuals such as VSB/Advanced 
| Functions System Generation , OS/VS 1 Storage Estimates and 0S/VS2 Storage 
| Estimates . 


CICS/VS REFERENCE SET 


The CICS/VS reference set for a particular transaction or operation is 
defined as the amount of real storage required to process the 
transaction without causing any page I/O. This storage does not include 
storage external to the CICS/VS partition or region, or storage in the 
| VSE GETVIS area, or the OS/VS OSCOR area. These requirements are 
discussed above. 

If several transactions of the same type are being processed 
simultaneously, more real storage will be needed. The reference set can 
be divided into a static part and a dynamic part. The former is 
independent of the transaction rate, whereas the latter is directly 
proportional to the number of transactions being processed concurrently. 
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Hence, the reference set for a particular transaction where T 
transactions are being processed simultaneously can be represented by 
the equation: 

Reference set = SRS + T x DBS 

where ll SRS ,t and ,, DRS H are the static and dynamic components of the 
reference set of a single transaction. 

In most CICS/VS systems several different types of transactions may 
be processed concurrently and estimation of the total reference set 
becomes more complicated* 

Each transaction being processed concurrently, whether of the same or 
different types, will have its own dynamic reference set. The total 
dynamic reference set is the sum of all the individual reference sets. 

To determine the dynamic reference set it is necessary to calculate 
the average number of transactions that are executing simultaneously. 

For conver s atio n al transactions , this should be taken as the number 
of transactions that are active, that is, the number of terminals signed 
on to a particular transaction. 

For non-conversational transacti ons, '•T 1 * can be calculated as 
follows. 

If "R 11 is the transaction rate of a particular transaction and ,, C ,t is 
the host processor (or CICS/VS) response time in seconds, the average 
number of simultaneous transactions is ,, CR W . However, it is necessary 
to make some allowance for the distribution of the transactions. To 
maintain a 10:1 chance (approximately) of not exceeding the T 
requirements, a value of T equal to 3 x CR should be used for that 
transaction. The value obtained should then be rounded up to the next 
whole number before multiplying it by the DRS value for that 
transaction. Values should be obtained for all the frequently used 
transactions and then summed. 

The total static reference set can be estimated as follows. Each 
transaction type is made up of a BASE (or ECHO) transaction with 
additional functions (for example, file control GETs or transient data 
PUTs). Each such function has a fairly well—defined static reference 
set. The total static reference set is the sum of the base reference 
set and all the static reference sets for the different functions which 
will be processed concurrently. Some allowance is also necessary for 
the size of CICS/VS tables which will depend on such things as the 
network size and the number of files and application programs. In 
addition, the reference sets of the application programs must be taken 
into account. Data for CICS/VS reference set calculations is given in 
Figures 8.4—1 and 8*4—2, below. 

It should be noted that it is not necessary to include all possible 
transaction types. The least frequently processed ones can be excluded. 
As a guide, those transactions which are executed less than once per «S« 
seconds should be excluded (where 51 S” is the larger of 100 or 
100/(transaction rate) where the the transaction rate is measured per 
second). 

An alternative method is to order the transactions (or programs) by 
frequency of use. Starting with the least frequently used transaction, 
divide the number of times it is executed by the total number of 
transaction executions. The values obtained for each transaction should 
be summed in order of ascending size starting with the lowest. When the 
sum has reached 0.05, all the transactions summed should be excluded 
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from the reference set. The number of transaction executions can be 
obtained from CICS/VS statistics output* 

The tables below give the following data: 

• The base and function static reference sets 

• Base and function minimum dynamic reference sets 

The data in these tables is intended to be used only as a guide. 
Allowance must be made for application programs, maps and data areas. 

The reference set will depend to a certain extent on where the 
various programs and maps are loaded into virtual storage. The sizes 
given are generally based on default loading. This can be improved (or 
degraded) by using the nucleus load table. 

Examples of the use of this technique of calculating reference sets 
are given in Chapter 8.7. 


CICS/VS REFERENCE SET TABLES 


The two following tables (Figures 8.4—1 and 8.4-2) give static and 
| dynamic reference set sizes for VSE and OS/VS systems. The sizes given 
under the "CICS/VS" heading include all CICS/VS components in the 
| CICS/VS partition. They do not include areas in the VSE GETVIS area or 
in the OS/VS area, even though they are in the CICS/VS partition. The 
column headed "OTHER” includes areas not included under the heading 
"CICS/VS” and may be in the CICS/VS partition or in the SVA or the LPA. 

Data for the following items is not given: 

• Supervisor code and control blocks 

• Application code, maps, and data areas 

The column headed "OTHER" includes components that may be used by 
several CICS/VS functions* When summing the various "STATIC” sizes, the 
same components (for example, VSAM) should not be added more than once. 

The data is approximate. It represents a medium system? actual 
installations may find that sizes vary depending on the exact options 
selected. 
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Notes: 


1. Minimum table sizes or optimum ordering of entries is assumed. 

2. CICS/VS user data areas are the larger of 256 bytes or minimum 
values. These include TIOAs and PIOAs. These minimum values are 
allowed for in the BASE sizes. 

3. Where values are not tabulated, it is recommended that virtual 
storage sizes are substituted for all frequently used functions. 
Infrequently used functions (for example , master terminal support 
for CSMT) should be ignored. 

4. It is assumed that CICS/VS modules only contain those functions 
that are frequently used. Hence, if the actual system contains 
functions that are used infrequently (for example. Terminal Control 
with sequential disk support) the sizes of these functions obtained 
from the virtual storage tables in Chapter 8.3 should be added to 
the reference set size. 
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Figure 8.4—1. CICS/DOS/VS Reference Set Sizes in K Bytes 
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Figure 8.4—2. (Part 1 of 2) CICS/OS/VS reference Set Sizes in K Bytes 
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Function 


I Static Reference Set || Dynamic Reference Set 


CICS/OS/YS 

Transient data 

— extrapartition 

+ intrapartition 
BDAH 

+ intra partition 
YSAM 


ICICS/VS |OTBBR |TOTAL 

f-1-1- 

I I I 

12 | 0 | 2 

I I I 

| 6 | 3DAM | 6+ 

| | | BDAH 

16+CISIZE| YSAN+I 6 + 

| |CISIZE| VSAM 

I I I 


CICS/YS 


OTHER 


TOTAL 


0 

0 

0 


0 

0 

0 


0 

0 

0 


Figure 8.4—2* (Part 2 of 2) CICS/OS/VS Reference Set Sizes in K Bytes 


Note : The "OTHER" column refers to OS/YS1 components, but will be 

approximately true for OS/YS2. CICS/YS figures include basic OSCOB 
requirements where appropriate (for example, YSAH control blocks in 
OSCOB are included in the CICS/VS column). 
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Chapter 8.5. Physical I/Os 


One of the important resources in a system is the disk I/O subsystem, 
which includes channels, control units and disk devices* To ensure that 
bottlenecks do not occur and that the response of the subsystem is as 
low as possible, it is essential to spread the load out evenly across 
the various devices. To do this, the system programmer must be aware of 
the load on the various disks. This can be related back to CICS/VS 
transactions if the number of physical I/Os (as distinct from logical 
I/Os) initiated by each CICS/VS function is known. 

Figures 8.5—1, 8.5—2, and 8.5—3 provide information on physical I/Os 
in relation to CICS/VS functions, and on the capabilities of disk 
devices. 

This chapter provides data that relates the number of physical I/Os 
to CICS/VS functions. For example, when a file control GET is issued to 
a VSAM KSDS file with three levels of index with the minimum buffer 
allocations, four physical I/Os will take place; three for index records 
and one for data. If the GET had been issued to a VSAM ESDS file, only 
one I/O would have taken place. If the two files had, for example, been 
placed on separate disks and if an equal number of logical I/Os had 
occurred for each file, there would be a 4:1 imbalance, probably 
resulting in poorer performance than necessary. 

Figure 8.5—1 gives average numbers of physical I/Os caused by CICS/VS 
functions. In some exceptional cases, there will be variations to these 
| values. In general, these values apply to both VSE and OS/VS systems. 
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I 


CICS/VS functions 

1 

1 

Average number of 
physical I/Os 


1 

VSE 

| OS/VS 

File Control 

1 

1 



BDAM PUT/GET 

1 

1 

1 

1 1 

GET (UPDATE) 

1 

1 

1 2 

PUT (UPDATE) 

1 

1 

| 1 

VSAM ESDS GET/PUT 

1 

1 

1 

| 1 

GET/PUT (UPDATE) 

1 

1 

1 

| 1 

KSDS with minimum buffer allocation 

If N is the number of index levels 
including the sequence set, then; 

1 

1 

1 

1 



GET 

! 

1+N 

| 1+N 

PUT 

1 

1+N 

| 1+N 

GET (UPDATE) 

1 

1+N 

| 1+N 

If one additional buffer allocated, 

1+N can be reduced to N. 

If more than one additional buffer, 
number is between N and N—1 

1 

1 

1 

1 



ISAM (cylinder index in core) 

1 

I 



GET 

1 

2 

1 2 

PUT 

1 

2 

1 2 

GET (UPDATE) 

1 

2 

1 2 

PUT (UPDATE ) 

1 

2 

1 2 

If cylinder index not in core, 
add 1 to the above values* 

Overflow records (GET), 
where F is the position of the 
record from the start of the 
chain. 

1 

1 

1 

1 

1 

1 

I 

2+F 

| 2+F 

Temporary Storage (auxiliary) 

1 

1 



GBT/PUT/GETQ 

1 

1 

1 

| 1 

POTQ 

1 

1 

1 

| 1 

Transient Data 

1 

1 



Intrapartition BDAM: 

1 

1 



PUT to queue 


2 

1 3 

PUT to empty queue 

1 

5 

1 3 

PUT to queue that fills the track 

1 

— 

1 6 

GET first record from queue 

1 

2 

1 4 

GET subsequent record from queue 

1 

I 

1 

| 2 

Intrapartition VSAM: 

1 

1 



GET 

1 

1 

| 1 

GET first record from queue 

1 

2 

I 2 

PUT 

1 

0 or 1 

| 0 or 1 

Note that PUT only causes I/O when! 



the Cl is full or unless BECOVEBY 
is specified. 

1 

1 

1 




Figure 8.5—1. (Part 1 of 2) Average Number of Physical I/Os for 
CICS/VS Functions 
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i 

I CICS/VS functions 

| Average number of 


• - ....- . -... 

| physical 

• 

I/Os 

i 

* 

IProaram Control 

1 

1 

i 

I Load a non-resident 

i 
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i 
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i 

1 program or map 

i 

i 

i 

| - VSE 

t i 

i 

i 

| - OS/VS 
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i 

t 

i 

i 

i 

INote: Ficrures are minimum 

I 

1 

1 

1 

1 

1 

(values. For large programs and programs 
jwith many RLD items. 

i 

i 

i 

i 

i 

|more I/Os may be required. 

i 

i 

i 

i 

i 

i 

IJournalina (user and automatic) 

1 

i 

I 

i 

1 

i 

| WRITE/PUT STARTIO=YES 

i 

i i 

i 

i 

i 

i 

| STARTI0=N0 

1 1/N 

i 

i 

| Where N is the effective 

| blocking factor governed 

| by the ratio of the 

| shift—up value to the 

| average journal record 

| size. 

1 

1 

1 

1 

1 

1 

i 

i 

i 

i 

i 

i 

i 

i 

i 

i 

i 

i 

a 

i_ 


_* 


Figure 8.5—1. (Part 2 of 2) Average Number of Physical I/Os for CICS/VS 
Functions 


CALCULATI ON O F DISK DEVICE SERVICE TIMES 


The disk service time is used in the next chapter to estimate response 
times. It does not include time spent waiting for service, and is not 
t he disk response time . 

To calculate the disk service time, both the disk device itself and 
the combined usage of the disK and channel must be considered. 

For the disk device there are several factors. These are: 

• The time taken to find the correct cylinder — this is known as the 
seek time. On average this is the time taken to traverse one third 
of the number of cylinders over which the data is spread. This is 
often taken as the whole disk and an average time is quoted. 
However, it is often true that there are relatively small, 
frequently used data sets where the total movement is limited to a 
few cylinders. One example is the page data set, which, if the 
reference set is fairly small (say about 250K bytes), would fit on 
one cylinder of a 3330, thus eliminating seek time completely if 
there were no other active data set on that device. 

• The time taken to find the start of the record. This is taken, on 
average, as half the time for one rotation of the disk. 

• The data transfer time, which is equal to the physical record 
length divided by the device data rate. 

Figure 8*5—2 below gives approximate values for these parameters for 
some common devices. 
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If RPS (rotational position sensing) is used, a fourth factor is 
brought into account, because when the head is reached by the 
sector that contains the start of the record, the channel must also 
be free* If it is busy, a further revolution will be necessary 
before the record can be read. Thus, several revolutions can take 
place even though the chance of this occurring gets progressively 
less* 

If the channel utilization is "Uc M , the average delay due to RPS is 
approximately: 


Average delay = rotation time x Uc/(1—Uc) 


i-1 


|Device | 

1 1 

1 t 

1 1 

| 

Minimum|Maximum 
Seek |Seek 

Time |Time 

(msec) | (msec) 

(Average 
| Seek 
(Time 
| (msec) 

(Time |Track|Number 
|for 1|Capac| of 
jrotatl—ity ITracks 
I-ion | | 

|Number| 

| of | 
(Cylindl 
|-ers j 

Device 

Capac 

-ity 

|Data 
|Rate (K 
| bytes 
I/sec.) 

12311 | 

1 1 

|2314/19| 

1 1 

13330-1 | 

1 1 

13330—111 

1 1 

13340-351 

1 1 

|3340-70| 

1 1 

13344 | 

1 1 

13350 | 

1 

■ - 

I 

1 75 

■ 

| 25 | 3625| 

III 

10 

| 200 | 

| | 

7.2 

| 156 

• 

- 

1 

| 

i 

| 60 

1 

1 1 1 
| 25 | 7294| 

1 1 1 
| 16*8|13030| 

20 

| 200 | 

| | 

29 

| 312 

1 

9 

1 45 
| 

1 30 
| 

19 

| 404 | 

I | 

100 

| 806 
i 

9 

1 

| 47 
| 

1 30 

■ 

III 

| 16*8|13030| 

1 1 1 
| 20.2| 8368| 

1 1 1 

| 20*2| 8368| 

1 1 1 

| 20*2| 8368| 

1 1 1 
| 16.8|19069| 

19 

| 808 | 

| | 

200 

| 806 

I 

8 

| 42 
| 

1 

1 25 

1 

12 

i 348 | 

| | 

34.9 

| 885 

| 

8 

1 

| 42 

1 

i 

1 25 

ft 

12 

1 696 | 

■ | 

69.8 

| 885 

- 

1 

| 

1 

1 25 
* 

12 

| 2784 | 

a a 

279.5 

| 885 

1 

5 

1 

| 40 

1 

1 25 

30 

1 555 | 

317.5 

| 1198 

Figure 8. 

5-2* 

Approximate DASD 

Timing Data 






Notes : 

1. Minimum seek times are times taken to move one cylinder. 

2. Maximum seek times are times taken to move from the first cylinder 

to the last. 

3. Unless specific data is available, the average seek time should be 

used. If active data sets on any device are in one area of the 
disk, the average number of cylinders moved should be assumed to be 
one third of the total spread of the active data sets. Having 
calculated one third of the total spread, the seek time to be used 
can be estimated from Figure 8*5—3; For example, if the total 
spread on a 3330—1 was 150 cylinders, one third would be 50 

cylinders* Hence, from Figure 8*5-3, the average seek time would 

be approximately 18.5 milliseconds. 

The interaction between the devices and the channel is complex but 
can be calculated approximately assuming that accesses are requested at 
random intervals. 

The channel utilization (Uc) is given by the product of the access 
rate (the sum of the access rates of all the devices on the channel) and 
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the meau channel service time (Tc) . The dish service tiae is then equal 
to the individual device service times (Td) plus the channel wait tiae. 

The channel utilization, service times, and access rates are found by 
using combined statistics for all the devices on the channel in 
question. This process is best illustrated by a simple example. 

The example assumes random distribution of service times and arrival 
times, which will give slightly pessimistic results in most cases. 

Suppose there are 4 dish drives with 3330—1 devices, with 32 I/Os per 
second spread evenly across the 4 devices. The bloch size is 3200, and 
the accesses are at random to data sets spread across the whole of each 
device, so that the average seeh values in Figure 8.6—2 can be used 
(that is, 30 milliseconds). It is assumed that RPS is not being used. 

The channel will be nusy during the rotation delay and the 
transmission time. 

The rotation delay (equal to half a total rotation)=8.4 milliseconds. 

The transmission tiae is equal to the bloch size divided by the 
device speed. 


= 3.2 x 10 s seconds divided by 8.06 x 10 s 
= 3.97 milliseconds 

Hence, the channel service tiae ( N tsc n ) is 3.97 ♦ 8.4 milliseconds. 

- 12.37 milliseconds 

If the total I/O rate is 32 per second, the channel utilization ("DC") 
is: 

32 X (8.4+3.97) x 10“3 
= 0.396 

Using the equation: 


Channel wait = 0c . tsc 
1 - Oc 

= (0.396 x 12.37)/(1 — 0.396) milliseconds 
= 8.1 milliseconds 

The total device service time is given by: 

Channel wait + rotation delay + seeh time + transmission 
time (if EPS=NO) 

Because the channel wait time = 8.1 milliseconds 
rotation delay tiae =8.4 milliseconds 
seeh tiae = 30 milliseconds 

transmission time = 3.97 

the total device service tiae is the sum of these values, that is: 

50.5 milliseconds. 
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Figure 8.5-3. Approximate DftSD Seek Times 
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Maximum Loading 


This chapter describes how to use the information that has been given in 
the preceding chapters of this part of the manual. 

Apart from an understanding of the amounts of the various resources 
required and their comparison to available resources, such data is 
useful as input to a model that can be used to calculate response time 
as a function of loading. This will enable the system programmer and 
the system designer to establish the maximum load that is consistent 
with an acceptable response time, together with the maximum load that is 
possible for the system (see Figure 8.6—1, below). Variations of the 
curve can be obtained by varying major parameters (for example, the 
number of disk devices.) 


Response 

(seconds) 



Figure 8.6—1* Response Times vs. Loading 

A rigorous model of the host processor and its associated processes 
is usually extremely complex. It is not the purpose of the chapter to 
discuss such a model, but to discuss a very simple approximate method 
based on queuing theory. 

It is emphasized that, because of the approximate nature of the 
method and possible inaccuracies in the input data# the absolute results 
produced are unlikely to be accurate . They will, however, be useful for 
predicting the effects of changes and understanding the observed 
behavior of the system. 

Readers who are familiar with the concepts and practice of queuing 
theory nay obtain more accurate estimates of response and loading limits 
by using a more complex model. 

The discussion that follows: 

1. Presents the simple equations that represent the behavior of the 
system 

2. Discusses the derivation of the input data 

3. Gives a simple example (a more complex one is given in Chapter 8.7) 
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4. Describes an extension to estimate the effect of page—faults 

5. Discusses some of the implications of intersystem communication 
(ISC) . 


THE SIMPLE MODEL 


This model can be used to estimate the host processor response time and 
maximum loading. It does not take account of any part of the network 
that is external to the host processor, although the technique can 
reasonably be extended to do this. 

The basic assumptions are that: 

• The host processor can he represented by two single server systems 
— the processing unit and the disk subsystem 

• There is no paging 

• There are no logical queues, for example, VSAM string WAITS 

If the service times and the interarrival times at a single server 
are random, the average time spent waiting for service is given by: 


tq = tsp/ (1-p) ...Equation 1. 

where ,l ts M is the average service time 
and u p n is the utilization of the server, 

and is given by: 

p ts/X ...Equation 2. 

where ,f X w is the interarrival time, which 
is the inverse of the transaction 
rate (R) in our case* 

The average response time is given by: 


tr = ts + tq 

In practice, in a computer system, while arrivals at a server tend to 
be random, service times are more regular and “tg" is given by: 


tq = ts.p.K/(1—p) ...Equation 3. 

where an empirical value of n K n of two—thirds is recommended. 

Variations of between 0*5 and 1*0 can reasonably be expected, depending 
on the system. 

Consider the two major subsystems: 

• The processing unit 

• The disk devices 

If the subscript ,, c ,f represents the processing unit, and ”d M 
represents the disks, from Equation 3 we have: 
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tq = tqc + tqd 


= (0.67) • tsc. pc/(1—pc) + (0.67) .tsd.pd/(1—pd) 
The average system response time is then calculated by 
tr = tgc + tqd + tsc + tsd 


...Equation 4. 
using the equation: 
...Equation 5. 


DERIVATION OF INPUT DATA 


The input data in question is: 

• Service times for the processing unit and the disks 

• Utilization for the processing unit and the disks 

Average service times {"tsc") for the processing unit are calculated 
by finding the average transaction pathlength and then by dividing by 
the processor speed (refer to Chapter 8.2). The utilization will then 
be the average service time multiplied by the transaction rate ( M R W ) . 

An addition may be made for background utilization. 

The average service time («tsd")for the disk subsystem can be found 
by multiplying the single disk service time (see Chapter 8.5) by the 
average number of physical I/Os executed in each transaction. For an 
approximate calculation, the single disk service time can be taken as 40 
milliseconds. If there are "N 11 disks in freguent use in the subsystem 
and the traffic is spread evenly across the disks, the utilization (pd) 
will be: 


pd = tsd.R/N 

The maximum possible transaction rate (Rmax) on a system is 
determined by the resource that is used-up first; in this case, it is 
the minimum of either: 


1/tsc or N/tsd 

where M N ,f is the number of disks in active use in the subsystem. These 
are the conditions that "pc" and w pd w are equal to 1. This, of course, 
implies that there are no artificial limits, as for example, AMXT. In 
practice, this limit is seldom achieved because of some unforeseen 
limit. 

If the traffic is not spread evenly across the disks, it will be 
necessary to calculate the maximum load by using the »tsd" value for the 
most frequently used disk, which is found by multiplying the single disk 
service time by the average number of I/Os per transaction to that disk. 


A SIMPLE EXAMPLE 


For the purposes of this example, the system has the following 
parameters: 

• tsc = 0*10 seconds (for example, transaction pathlength=95000 on a 
System/370 model 158—3) 
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• Average single disk service time = 0*040 seconds 

• Active data sets are spread over 3 disks 

• There are 10 physical I/Os per transaction 

The objective is to calculate the response time as a function of the 
transaction rate. 

The maximum load is calculated first. 

• For the processing unit, the maximum load is 1/tsc: 

= 1 /( 0 . 10 ) 

= 10 transactions per second 

• For the disk subsystem, the service time (tsd) is given by: 

tsd = 10 x 0.040 = 0.4 seconds 

and the maximum load is: 

HT/tsd 
= 3/0,4 

= 7.5 transactions per second. 


Hence, the maximum possible system rate will be 7.5 transactions per 
second — that is, the smaller of 10,0 and 7.5. 

The queue and response times may now be calculated at a variety of 
transaction rates up to 7.5 transactions per second. 

Take, for example, a rate of 5 transactions per second. 

• For the processing unit, using Equation 2 and 3: 

pc = 5 x 0.10 =0.5 

and tgc = 2/3* tsc.pc/ (1-pc) 

= 2/3 x 0.10 x 0.5/(1-0.5) 

= 0.067 seconds 

• For the disk subsystem. 


pd = 5/3 x 0,40 
= 0.67 

That is, tgd = 2/3 x 0.40 x 0.67/(1-0.67) 

= 0.53 seconds. 

Using Eguation 2, the system response time is: 

0.53 + 0.40 + 0.067 + 0.10 
= 1.10 seconds 


By using the same method, values for 1, 2, 3, 4, 6, and 7 
transactions per second can be calculated. The results are shown in 
Figure 8.6—2, below. 
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1--- 

|R/sec 

|tgc (sec) 

|tqd (sec) 

Itr 

(sec) 

i 


1 

| 0.007 

| 0.040 

1 

0.55 



2 

| 0.017 

| 0*097 

1 

0.61 



3 

| 0.029 

| 0.179 

1 

0.71 



4 

| 0.045 

| 0.305 

1 

0.85 



5 

| 0.067 

| 0.534 

1 

1.10 



6 

| 0.101 

| 1.068 

1 

1.67 


1— 

7 

| 0.156 

| 3.720 

I 

4.38 



Figure 8.6—2. Sample Queuing and Response Times 


If, for example, the minimum acceptable response for the processor 
(that is, the total response minus the network contribution) was 1.5 
seconds, the maximum rate would be just over 5.5 transactions per 
second. 

It should be remembered that average response times are being 
discussed. When specifying system requirements, response times are 
sometimes specified as 90% (95%) should be less than ,l n M seconds 11 . 
Depending on the distributions, the M 90%» value lies between 1.2 and 1.3 
times the average, and the ,, 95% ,t value lies between 1.3 and 1.7 times 
the average value. 1.3 and 1.7 respectively are practical values to 
use. 


The above calculation assumes that the different transactions all 
present a similar load on the system. If there is a wide variation of 
transaction service times, individual service times should be calculated 
for each type, and the averag e queue time should then be added to give 
individual response times. In this case, the 90% and 95% multiplying 
factors will only apply to individual transaction response types, and 
not to the average response . 


TREATMENT OF PAGE-FAULTS 


Some page—faults occur in most systems and so it is necessary to be able 
to quantify their effect. Unfortunately, there is no simple analytic 
technique available that can be used to calculate the probability of a 
page—fault occurring. However, a page—fault rate can either be measured 
or assumed, and having done this the impact of the page—faults can be 
estimated• 

When a page—fault occurs in a CICS/VS partition or region, the whole 
partition or region will wait until the page—fault is resolved. Other 
partitions can continue processing during the I/O time. This nas two 
consequences: 

• There will be no queue to the page data set for CICS/VS pages, 

because a second page—fault cannot occur until the first has been 
resolved. Hence, for a first approximation, the page—fault 
resolution time can be taken as being independent of the 
transaction rate. This, of course, assumes that no other I/O Is 
being performed to the disk that holds the page data set and that 
channel utilization is low. If not, the technique in Chapter 8.5 
should be used to calculate the variation with load. In addition, 
the time taken to execute the instructions used in page—fault 
handling should be added. Refer to Table 2 in Chapter 8.2. 
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• The time that the processor is available to execute "useful" 
instructions is reduced by the product of the resolution time and 
the page—fault rate in every second* 

The previous technique can now be used to calculate the new queuing 
times, because only a new (increased) «pc« value need be calculated. 

This can be used to calculate a new "tqc" value. The page—fault service 
time is then added to give the new response time. 

Consider the previous example, but, in addition, assume that: 

• The page—fault resolution time is 35 milliseconds (refer to Chapter 
8.5 for the methods of estimating this), and the page data set is 
on a fourth disk. 

• The page—fault rate is 10 page—faults per second* 

• The transaction rate is 5 per second* 

Bence, there will be two page—faults per transaction, and the page- 
fault service time per transaction (tsp) will be 0.070 seconds. 

The proportion of the processing unit available for "useful" 
instruction processing in the CICS/VS partition will be: 


1*0 - (0.035 x 10) 
= 0.65 


Hence, the effective utilization at 5 transactions per second with 
"tsc" equal to 0.1 is increased from 0*1 x 5 to (0*1 x 5)/0.65* 

Using Equation 3, 


tqc * 0*10 x 2/3 x 0.77/(1-0.77) 

= 0.224 seconds* 

Adding the page—fault service times and using the new value "tqc". 
Equation 5 gives: 


tr = 0.10 + 0.224 + 0.4 + 0*534 + 0.070 
= 1.33 seconds 

which is an increase of nearly a quarter of a second. 

The other point of interest is that the maximum transaction rate is 
now 6.5 transactions per second, and the limiting factor is the 
combination of the processor and the paging, rather than the disk 
subsystem. 

Increasing the paging rate only slightly above 10 per second would 
cause a large increase in the response time, causing the maximum 
throughput of the system to be decreased, if the limit on acceptable 
response was maintained. 

It should be remembered that if the page—faults are spread over 
several partitions or regions, this technique will overestimate the 
effect because the batch partition(s) could run while CICS/VS was 
waiting for a page fault, and vice versa. 
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INTERSYSTBM COMMONICATION (ISC 


| With parallel sessions, VTAM can multiplex sessions on an ISC link as on 
| any other, and, given an adequate numer of sessions, there are no 
| special performance characteristics distinct from those of other CICS/VS 
| terminal support. 

| If only single session support is used, this will place a limitation 
| on intersystem throughput. 

The components in the path between the systems will vary according to 
the installation. Communication could be through a "twin—tail 11 3705 
providing something close to channel—to—channel communication, or it 
could be through a teleprocessing line. A simple calculation may be 
performed to estimate the limitation. The communication line system is 
taken as an example. 

N otes : 

1. The ISC timing overhead is less when the NOCHECK option is used. 

2. When the NOCHECK option is used, there is one path, not two, for 
each 3705. 

There are five basic components for the communication line system. 
These are shown below. 


| Local |—>-1 37051 TP line 

| processor j —<--«-><- 


3705,—>- 


(Remote | 
-| processor | 


It is assumed that: 


• The load on the processor due to the ISC part is small, and that 
the total processor utilization is constant at, say, 75%. 

• The response time of the 3705 is constant at 25 milliseconds (any 
variation will be small compared with the overall response) . 

• The data transmitted on the line is large compared with the control 
characters and controls that are issued by VTAM. It is assumed 
that each transaction sends 200 bytes and receives 1000 bytes. 

It has been assumed that the operations are all of the ,, simple ,, type 
originating from the local processor and that a BID is never required. 

The following points are also assumed: 

• An average "operation” processor time of 5 milliseconds 

• A command—level interface overhead of 6% (for PL/1) — 0*3 
milliseconds 


• An ISC overhead of 19.4 milliseconds on the local system (for 
OS/VS 1) 

• An ISC overhead of 19.1 milliseconds on the remote system (OS/VS 1) 

The service times for the local processor is 19.4 + 0.3 = 19.7 
milliseconds, and 19.1 + 5.0 = 24.1 milliseconds for the remote 
processor. 
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The response times of the processors for the thread can then be 
calculated by the same method used earlier in this chapter. For a 
utilization of 75*, the local system response is: 


19*7+ 0.67 x 0.75 x 19.7 
1-0.75 

=59.1 milliseconds 

The remote system response is: 


24.1 + 0.67 x 0.75 x 24.1 
1-0.75 

=72.3 milliseconds 

For simplicity, it has been assumed that there is no I/O on the 
remote system• 

There are two paths through each 3705; hence the total 3705 response 
is 4 x 25 or 100 milliseconds. 

For the communications line, the response time eguals the service 
time because there is a single—thread operation. 

Assuming a rate of 4800 bits per second (600 characters per second), 
the total line time will be: 


1000 + 200 seconds 
600 

=2 seconds 

Hence, the total response is the sum of the following: 


The line: 2000 milliseconds 
The 3705: 100 milliseconds 
The local processor: 59.1 milliseconds 
The remote processor: 72.3 milliseconds 


2231 milliseconds 

The maximum possible throughput will be approximately 1/2.231 or 0.45 
transactions per seconds. It should be remembered that actual ISC 
responses will be longer if the actual interarrival time of the ISC 
requests is not constant. 

If a "twin—tail 11 3705 had been used so that the communication line 
delay was eliminated, the ISC response (service time) would have been 
approximately 232 milliseconds, which would have allowed a maximum of 
over 4 requests per second. 
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Chapter 8.7. Examples of the Estimation Process 


In order that the reader can see how the estimating techniques that have 
been described in previous chapters are to be used, a complete example 
is given in this chapter, which follows through each of the processes 
described in Chapters 8.2 through 8.6. The processes are: 

• Calculating the processor utilization 

• Calculating virtual storage requirements 

• Calculating real storage requirements 

• Calculating I/O device utilization 

• Estimating response times and maximum loading. 


SYSTEM DE FINITION 

Firstly, the system whose resources are to be estimated is defined, as 
follows: 

| • System/370 model 125—2 with 512K bytes using VSE 

• 60 terminals, comprising 50 remote 3277 displays and 10 local 3270 
displays 

• The remote devices are attached through 5 lines 

• CICS/VS Version 1, Release 4 with BTAM, ISAM, and BDAM 

• ICV=5000 milliseconds 

• No batch 


APPLICATION DEFINITION 


Four main transactions are assumed: APPA, APPB, APPC, and APPD. All 
other transactions are used infrequently. Functions used by each 
transaction are given in Table 12, below. These are in addition to the 
system function. 
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| Functions 


| APPA 


| APPB | APPC 


| APPD 


BDAM GET 

GET (UPDATE) 
PUT (UPDATE) 

ISAM GET 

GET (UPDATE) 
PUT (UPDATE) 

Transient Data 
PUT 
GET 


TYPE=MAP 

TYPE=OUT,DATA=YES 

DATA=NO 

DATA=ONLY 

Subroutine Calls (LINK) 

Additional TC Output 

Application Pathlengths 
(in 1000s) 

Programming Language 


Transaction Rate/Second 
(System total = 1.2) 


Macro 

assembler 


Command 

COBOL 


Macro 

assembler 


Command 

COBOL 


Table 12. CICS/VS Functions for Transactions APPA, APPB, APPC, and APPD 
N otes : 

• BMS maps are composed of 20 fields: 10 data fields and 10 
preformatted fields. On input, an average of 5 fields are 
modified. 

• All message lengths are less than 256 bytes 

• The cylinder indexes of the ISAM files are in main storage 

• It is assumed that the transaction types are spread evenly over the 
different terminals 

• Assume that 1 in 5 transient data PUTs and GETS are the first 
record on a track 
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CALCULATE PROCESSOR UTILIZATION 


The process has the following stages: 

1. Calculate the timings of each transaction on the hypothetical 
standard processor 

2. Calculate the processor utilization for each transaction 

3. Calculate the background processor utilization 

4. Calculate the overall processor utilization 

These stages are discussed in the following sections; 


ESTIMATE THE TRANSACTION TIMINGS 


The system component ("ao 1 *) is calculated first. Because there are two 
types of terminals, a weighted average is taken. 

The system component for the remote 3270s is 22 milliseconds; for 
local 3270s, 10 milliseconds. 

Because there are 50 remote and 10 local terminals, the weighted 
average is given by: 


System timing = 5 x 22 ± 1 x 10 

6 

= 20 milliseconds 

To this system timing is added the network component, which is given 

by: 


bL + cT ♦ dT/L 

The total number of terminals is 60 and the number of lines is 6. 
(The local 3270s are treated as if they were on one line.) Hence, using 
| the values of b, c, and d from Table 2 in Chapter 8.2: 


Network component = 0.120 x 6 + 0 x 60 + (0.24) x 10 

= 3.120 milliseconds 

Note : For CICS/VS Version 1, Release 3, this value would have been 5.66 

milliseconds. 

Finally, ,l a 1 M values are calculated. Individual function times are 
| taken from Table 2 (in Chapter 8.2) and are summed, as below. 
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APPA 


2 

X 

BDAM 

GET 


at 

2*4 

each 

1 

X 

BDAM 

GET 

(UPDATE) 

at 

3.0 

each 

1 

X 

BDAM 

PUT 

(UPDATE) 

at 

2.8 

each 

1 

X 

transient 

data PUT 

at 

4.6 

each 


Application code 


"ai" for APPA 
APPB 


1 

X 

ISAM 

GET 

at 

5.5 

each 

1 

X 

ISAM 

PUT (UPDATE) 

at 

5.4 

each 

1 

X 

ISAM 

GET (UPDATE) 

at 

5.5 

each 

1 

X 

transient data PUT 

at 

4.6 

each 

1 

X 

BMS 

MAP 

at 

2.40 

each 

1 

X 

BMS 

OUT,DATA^NO 

at 

3.20 

each 

1 

X 

BMS 

0UT,DATA=ONLY 

at 

3.0 

each 

2 

X 

LINK 

+ RETURN 

at 

0.42 

each 

1 

X 

TC output 

at 

10.78 

ea ch 


Application code 


Command level COBOL 
"a!" for APPB 

APPC 


2 

X 

BDAM GET 

at 

2.4 

each 

2 

X 

ISAM GET 

at 

5.5 

each 

1 

X 

transient data PUT 

at 

4.6 

each 

1 

X 

BMS OUT,DATA=YES 

at 

3.90 

each 

1 

X 

LINK + RETURN 

at 

0.42 

each 


Application code 
••aj” for APPC 

APPB 

2 x ISAM GET (UPDATE) at 5.5 each 

2 x ISAM PUT (UPDATE) at 5.4 each 

5 x transient data (GET) at 3.96 each 

1 x LINK + RETURN at 0.42 each 

1 x BMS MAP at 2.4 each 
1 x BMS OUT,DATA=YES at 3.9 each 
Application code 
Command level COBOL 
,, a 1 » for APPD 


4.8 milliseconds 
- 3.0 milliseconds 

= 2.8 milliseconds 

= 4.6 milliseconds (see Note 1) 

= 1.5 milliseconds 

= 16.2 millisecond s 


= 5.5 milliseconds 

= 5.4 milliseconds 

= 5.5 milliseconds 

= 4.6 milliseconds (see Note 1) 

= 2.4 milliseconds (see Note 3) 

= 3.2 milliseconds (see Note 3) 

- 3.0 milliseconds (see Note 3) 

= 0.82 milliseconds 

= 10*78 milliseconds 

= 4.0 milliseconds (see Note 5) 

~ 7.57 milliseconds (see Note 4) 

= 52.78 milliseconds 


= 4.8 milliseconds 

= 11.0 milliseconds 

= 4.6 milliseconds 

= 3.9 milliseconds (see Note 3) 

= 0.42 milliseconds 

= 3.0 milliseconds 

= 27.72 milliseconds 


= 11*0 milliseconds 

= 10.8 milliseconds 

= 19.8 milliseconds (see Note 2) 

= 0.42 milliseconds 

= 2.4 milliseconds 

= 3.9 milliseconds 

= 5.0 milliseconds 

= 6.08 milliseconds 

= 59.40 milliseconds 


Notes: 


1. Average transient data PUT = 

4 x 3.5 + 1 x 9.0 = 4.6 milliseconds 

5 

2. Average transient data GET = 

4x3.2+ 1x7.0 = 3.96 milliseconds 

5 

3. For the maps in use, pathlengths are with 10 data fields and 
10 format fields. 

TYPE=MAP = 2.4 milliseconds (only 5 fields are modified) 

TYPE=OUT,DATA=ONLY = 3.0 milliseconds 

,DATA=N0 = 3.2 milliseconds 

,DATA=YES = 3.9 milliseconds 
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4. For COBOL, add 0.45 milliseconds plus 0.04 per call; for the 
command level interface/ add instructions according to Table 3 
in Chapter 8.2. 

5. Loaded value according to the percentage of remote and local 
terminals and including the network component (0.5 x 96). 

Using Equation 2 in Chapter 8.2/ (P * a 0 + a x + b*+2L + C*+2T + 
(d*+2T/L))/ the average values of the timings for each transaction 
are: 


APPA= 

APPB= 

APPC= 

APPD= 


39.32 milliseconds 
75*9 milliseconds 
50.84 milliseconds 
82.52 milliseconds 


CALCULATE THE TRANSACTION PROCESSOR UTILIZATION 


From Table 4 in Chapter 8.2/ a System/370 Model 125—2 has an average 
relative power factor of 120. 

The total time the processor is busy in each second for each 
transaction is the processor time («p«) multiplied by the individual 
transaction rates. The values calculated are shown below. 


| Transaction|Transaction rate/sec•|Time(milliseconds) 
I- 


APPA | 

0.3 

| 11.80 

APPB | 

0.4 

| 30.36 

APPC | 

0.3 

| 15.25 

APPD | 

0 .2 

| 16;50 

Total | 

1.2 

| 73.91 




The total time is divided by 120 (the relative power factor) to give a 
utilization of 0 .616 ^ 


CALCULATE THE BACKGROUND PROCESSOR UTILIZATION 

The ICV value is 5000 milliseconds (that is, 5 seconds) • The number of 
lines ("L”) is 6/ and the number of terminals (»T fl ) is 60 * 

The pathlength per ICV scan is approximately: 

P= X + Y*+2L + Z*+2T ♦ V (see Equation 4 in Chapter 8.2) 
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In this case, V=0 (VTAM is not used) 
| ana for VSE X=1.0 

Y=0*05 

Z=0 


Hence, P =1.3 milliseconds 

The intercept value "A" is now calculated from the equation: 


A= 1000*+2P/(ICV x F) 

Because F (relative power factor) = 120 
A = (1000 x 1.3)/ (5000 X 120) 

= 0.0022 or 0.22% 

Note : For CICS/VS Version 1, Belease 3, this value would have been 

0.9%. 

The overall processor utilization is the sum of the previous two 
stages. The value obtained is: 


Otilization = 0.616 + 0^002 
= 0.62 

Expressed as a percentage, this is 62J> 


ESTIMATE THE CICS/VS BEFBRBNCB SET 


The static reference set is calculated first. The superset of all the 
functions used by the four frequently used transactions (APPA, APPB, 

APPC, and APPD) is the list given in Table 12. The system functions 
used are BTAM 3270 (local) and 3270 BSC (see Table 1 in Chapter 8.2). 

From the "TOTAL” column in Figure 8.4—1 in Chapter 8;4, the following 
can be seen: 
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| Function 

| Static Beference 
| Set (K bytes) 

Set i 

| System—see Note 

1 57 


| BMS 

1 8 


| Command level 



| interface 

1 10 


| File control 



| (B DA M/ISAM) 

1 14 


I Per file 



| -2xBDAM 

1 2 


| —2xISAM 

1 2 


| COBOL 

1 2 


| 6 BTAM lines 

| 0.72 


| 60 BTAM devices 

I 12 


| Transient data 

1 6 


| Total 

| 114K bytes 


| (rounded up) 



L 


_i 


Notes ; 

1. A combination for local and remote is not given in the table. The 
value was obtained by taking the 3270 BSC figure, adding the local 
3270 code size (from DFHTCP virtual storage sizes in Chapter 8.3), 
and calculating the BTNOD size for local and BSC 3270s from the 

I VSE/Advanced Functions System Generation manual. Approximately 2K 

bytes has been added for the CICS/VS part, and IK bytes for BTMOD, 
making a total of 57K bytes for the system component. 

2. The “per file* 1 values were estimated from DFHFCT requirements, 
rounded up to the next page boundary. 

| If we assume a VSE supervisor size of 64K bytes for this example, 
this would give a total static size of 178K bytes. 

We can now calculate the dynamic requirement. 

The average transaction rate is 1.2 transactions per second, and the 
appropriate host processor response can be calculated to be 
approximately 1.6 seconds. The product of these two values is 
approximately 2.0. To preserve at least a 10:1 chance of not causing 
paging, we need approximately 2.0 x 3, or 6 times the DBS * 

Using Table 12 in this chapter and Figure 8.4—1, the DBS can be 
calculated to be approximately 16K bytes, that is, approximately 96K 
bytes (16 x 6) are needed. If a 4:1 chance is acceptable, we need 
approximately 64K bytes (that is, 2 x C x B x DBS). 

Taking the last value, we see that the total requirement is 242K 
bytes, which matches the available storage of 256K bytes. The larger 
value of 96K bytes estimated to be the storage necessary to give about a 
10:1 chance of not encountering a page fault requires 278K bytes. This 


Chapter 8.7. Examples of the Estimation Process 


673 






implies that the system would run reasonably well with only an 
occasional page fault. 


ESTIMATING VIRTUAL STORAGE REQUIREMENTS 


The first step is to choose the approximate example given for operating 
system and access method requirements (Table 6 in Chapter 8.3). 

Prom this we chose the minimum system with 200K bytes. 

We now calculate the CICS/VS requirements. 

Firstly, resident module sizes. The modules to be used and their 
sizes are taken from Table 7 in Chapter 8.3. These are (in K bytes): 


DFHCSA 4 
DFHKCP 7 
DFHSPP 2 
DFHSCP 6 
DFHPCP (COBOL 8 assembler) 5 
DFHTCP 

(Local 8 Remote 3270 8 Console Support) 12 
DFHZCP group 2 
DFHSDAM 2 
DFHFCP 6 
DFBTDP 3 
DFHEIP 11 
DFHTRP (Auxiliary) 9 
DFHDCP (Tape) 36 
BMS (Minimum 3270) 6 

Module Total 11 IK bytes 


Note: All modules have been rounded to the next K bytes for ease of 
calculation since we are only interested in an approximate figure for 
virtual storage. 

The next set of sizes belongs to CICS/VS programs residing in the 
PPT• We assume that all these programs will be made resident in virtual 
storage. 

The basic sets of modules are (in K bytes): 


DFHJxx — Journaling 8 
DFBMTxx — Master Terminal 80 
DFHSTxx — Statistics 26 
DFHTAxx — Terminal Abnormal Condition Program 6 
DFHOCP — Dynamic Open/Close Program 4 

Module Total 124K bytes 


It is now necessary to estimate the size of the CICS/VS tables. The 
major tables are: 


DFHPCT, DFHPPT, DFHFCT, DFHDCT, DFHTCT and DFBTRT 

For the purposes of this example, we will assume that, including 
required entries, the numbers of entries and sizes (rounded to the page 
size) are (in K bytes): 
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DFriPCT 

50 

entries 

4 

DFHPPT 

80 

entries (10 COBOL) 

6 

DFHFCT 

10 

files (5 BDAM, 5 ISAM) 

12 

DFHDCT 

16 

destinations 

6 

DFHTCT 

60 

terminal entries 8 3TM0D 

26 

DFHTRT 

500 

entries 

8 



Module Total 

62K bytes 


The next step is to estimate the size of the application programs and 
maps. It will be assumed that they are all resident in virtual storage 
and that the total size is 120K bytes. 

The final step is to calculate the dynamic storage area size. MXT 
(the limit on the number of simultaneous tasks) is assumed to be 10. 

For the most frequently used transactions (APPA, APPB, APPC and APPD) 
the maximum storage used, is assumed to be 12K bytes for the purposes of 
this example. Hence a DSA of 120K bytes would be adequate. In 
addition, an allowance of 16K bytes is made for the storage cushion, 
giving a total of 136K bytes. 

In summary we have (in K bytes): 


System 

200 

Nucleus 

111 

Other CICS/VS Modules 

124 

Tables 

62 

Applications 

120 

DSA 

136 


753K bytes 

Since the cost of having too little virtual storage is far greater 
than having too much, the total size should be increased by about 10%, 
as a contingency, to 82QK bytes . 


E STIMATE THE NUMBER OF PHYSICAL I/OS AND THE DEVICE SERVICE 
TIMES 


Here we use Figure 8.5.1 and calculate the number of I/Os for each 


transaction 

according to 

the functions invoked by each one. 

APPA 

6.6 I/Os 

(Note: Each transient 

data PUT averages 2.6 I/Os 
for the environment of this example) 

APPB 

7.6 I/Os 


APPC 

8.6 I/Os 


APPD 

15.0 I/Os 



Multiplying each of these by the transaction rates and summing them, we 
see that the total I/O rate is 10.6 per second. 

For the purposes of this example, because 3.8 I/Os per second are to 
the transient data destinations, we assume that 3.8 I/Os per second go 
to a single disk and that the other 6.8 per second are spread over two 
further devices. The devices are 3340s with a capacity of TOM bytes. 

For the transient data device we make the assumption that the data 
sets only spread across 3 cylinders, giving an average seek time of only 
8 milliseconds. On the other two devices, we take the average seek time 
of 25 milliseconds. The rotation delay is 10.1 milliseconds in both 
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cases. The average record length (for this example) is assumed to be 
512 bytes in all cases, so that the average transfer time is 0.5/885 
seconds, that is, approximately 0.56 milliseconds. 

The channel service time ( ,, tsc H ) is thus: 10.1 + 0.56 = 10.66 
milliseconds. Since the total channel rate is 10.6 per second, the 
channel utilization (**Uc») is: 


10.6 x 10.7 x 10~ 3 = 0.114 

Using the equation: Channel wait - tsc x Uc/(1-Uc) 

= 10.7 x 0.114 

0.886 

= 1.34 milliseconds. 

Hence, for the transient data device, the service time is 10.7 + 1.34 
+ 8.0 = 20.04 milliseconds. For the other devices, the service time is 
10.8 + 1.34 + 25.0 = 37.04 milliseconds. 


ESTIMATING THE AVERAGE RESPONSE TIMS 


An approximate value of the average response time for the system is now 
calculated using the simple method described in Chapter 8.6 


The average processor service time = 

Hence the processor queue time "tqc” 

tqc = 0.67 x 0.52 x 0.62 

1-0.38 


Processor utilization/transaction 
rate per second 
0.62/1.2 
0.52 seconds. 

is given by: 


= 0.57 seconds 

giving an average processor response time of 0.52 + 0.57 = 1^0 9 seconds. 
The average disk queue time is calculated as follows: 

The average service time ,f tsd H = 


3.8 x 20.14 + 6.8 x 37.14 

10.6 

= 31.05 milliseconds 
= 0.031 seconds 

The utilization is given by «tsd« x disk access rate/number of disks 

= 0.031 x 10.6/3 

= <LJJL 

Since the average number of disk accesses per transaction is 10.6/1.2 
= 8.83 per transaction, the average disk service time for each 
transaction is: 
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8.83 x 31*0 = 274.0 milliseconds 
= 0.274 seconds . 

Hence, "tgd" = 0.67 x 0.274 x (0.11/1-0.11) 

= 0.023 seconds 

so that the average disk response is 0.274 + 0.023 = 0.297 seconds. 

Hence, the average response in the processor is given by: 

tr = trc + trd 
= 1.09 + 0.297 

= 1.39 seconds 


This calculation has assumed no page faults. 

Taking the very approximate value of 25 milliseconds to resolve a 
page fault, we can see that even if the system suffered 10 page faults 
per second, the processor M g M times would be significantly increased 
because only 750 milliseconds in each second would be available for 
useful work, and the effective utilization would become approximately 
83% (62% divided by 0.750), making the gueue time egual to: 


0.67 x (0.83/1—0.83) x 0.52 

= 1.70 seconds , an increase of 1.13 seconds. 

Adding the contribution to the response due to the page faults (0.25 
seconds), the overall response would become about 2.8 seconds , an 
increase of about 1.4 seconds. 

Hote that no estimate has been made for increased channel and disk 
utilization, although in many situations the page data set would be on a 
different device from the other data sets. 
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Chapter 8.8. CICS/VS Monitoring Facilities 


This chapter describes both the type and format of data created by the 
CICS/VS Monitoring Facilities. 

The CICS/VS Monitoring Facilities allow the user to collect 
statistical data at defined points in the system on a transaction basis. 
The data is recorded in CIC/VS journal data sets and can be analyzed 
using either a user written analysis program, or IBM supplied analysis 
programs such as the Installation Management Program Products. A sample 
program (DFHXMOLS), which will list the dataset produced, can be used as 
a model for reading the data. 

The data is collected, by monitoring class, at Event Monitoring 
Points (BMPs) in the CICS/VS system which can be both system and user 
defined. User EMPs are defined in the Monitoring Control Table (MCT), 
which also defines the data sets to he used as destinations for each 
class of monitoring data collected. Refer to the description of the 
DFHMCT macro instruction in Chapter 3.2 of this manual for details of 
user EMP definition. 


MONITORING CLASSES 


There are three classes of monitoring available, each of which can be 
active independently, or jointly with other classes. The classes, and 
the type of data they record, are as follows. 


ACCOUNTING CLASS 

This class will record the minimum data required to associate particular 
transactions with particular users or terminals. The information 
collected will include: 

• Transaction identification 

• Terminal (or facility) identification 

• Operator identification 

• Task type 

• Number of transactions 

• Number of failing transactions (abends) 

• Number of output messages 

• User count 
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PERFORMANCE CLASS 


This class can be used to observe the performance of the system. 

The information recorded in this class, for each task, will includes 

• CPU time used 

• Number of data base calls 

• Amount of storage used 

• Amount of other resources used 

This information could be used periodically to calculate the charges 
applicable to different tasks. The charging information contained in 
the installation accounting programs (which could use the data provided 
by the Accounting class) could then be updated. 


EXCEPTION CLASS 


This class will record exception data on a task basis for the following 
resources: 

• Main storage 

• Auxiliary temporary storage 

• VSAM strings and buffers 

• ISAM overflows 

An exception record will be created each time one of the above resources 
hits a bottleneck. If performance class data is also being recorded,it 
will keep a count of the number of exception records generated for each 
task. The exception records can be related to the performance data by 
the numeric task identification that is contained in both records. 


U SING THE CIC S/VS MONITORING FACILITIES 


To use the CICS/VS Monitoring Facilities, the system programmer must 
ensure that: 

• The Monitoring Control Table (MCT) specifies the monitoring actions 
to be taken, for each monitoring class required, at each user Event 
Monitoring Point (BMP) . 

• Each BMP has an identification number allocated to it. (It is 
advisable to use a small range of numbers for this.) 

• The destination dataset for each class of monitoring data is 
defined and the Journal Control Table (JCT) contains a 
corresponding entry for each one. (The FORMAT operand of the 
DFHJCT TYPE^BNTRY macro must have a value of SMF for monitoring 
journals.) 
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• The monitoring classes which are to be initially active on the 
CICS/VS system are specified in the MONITOR operand of the DFHSIT 
macro. 

• The special entries required for monitoring are included in the PPT 
and PCT by specifying FN=STANDARD on the DFHPPT TYPE=GROOP and 
DFHPCT TYPE=GROUP macro instructions. 

During CICS/VS execution, the Master Terminal operator can switch on and 
off the data recording for each class using the online task CSTT MONITOR 
which enables commands of the form: 

CSTT MONITOR, {ON |OFF}={([ ACC ][,PER ][,EXC]) | ALL} 
to be issued. 


RECORDS AND INFORMATION PRODUCED BY THE MONITORING CLASSES 


The format and contents of the data produced by the different monitoring 
classes are shown below. The data is self defining in that the 
dictionary will explain the meaning of each field and give it an 
identifier. This identifier will appear with the data field. 


Accounting Class 


MF2TRID 

DS 

CL4 

transaction identification 

MF2TEID 

DS 

CL4 

terminal identification 

HF20PID 

DS 

CL3 

operator identification 

HF2TRTY 

DS 

C 

transaction type 

MF2TRCT 

DS 

H 

transaction occurrence count 

HF2TRAB 

DS 

H 

transaction abends 

MF2TRIM 

DS 

H 

input messages 

MF2UCNT 

DS 

XL4 

user count 
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Performance Class 


BF3TRID 

DS 

CL4 

transaction identification 

BF3TEID 

DS 

CL4 

terminal identification 

BF30PID 

DS 

CL3 

operator identification 

BF3TRTY 

DS 

C 

transaction type 

BF3ATTT 

DS 

XL8 

attach tod 

BF3DETT 

DS 

XL8 

detach tod 

BF3PGBN 

DS 

CL8 

program name 

BF3DIST 

DS 

CL6 

task dispatch time 

BF3CP0T 

DS 

CL4 

task processor time 

BF3TCWT 

DS 

CL6 

waiting for tc i/o 

BF3FCWT 

DS 

CL6 

waiting for Fc i/o 

BF3JCWT 

DS 

CL6 

waiting for jc i/o 

BF3TSWT 

DS 

CL6 

waiting for ts i/o 

BF3SUST 

DS 

CL6 

time on suspend chain 

BF3PINBC 

DS 

H 

tc input count — primary facility 

BF3P0NBC 

DS 

H 

tc output count — primary facility 

BF3SINBC 

DS 

H 

tc input count — secondary facility 

BF3S0UBC 

DS 

H 

tc output count — secondary facility 

BF3TAC 

DS 

H 

tctte allocate count 

MF3FCGC 

DS 

H 

fc get count 

BF3FCPC 

DS 

H 

fc put count 

KF3FCBC 

DS 

H 

fc browse count 

BF3FCAC 

DS 

B 

fc add count 

BF3FCDC 

DS 

a 

fc delete count 

HF3FC0C 

DS 

H 

fc other count 

BF3FCABC 

DS 

H 

fc access method count 

BF3TDGC 

DS 

H 

td get count 

BF3TDPC 

DS 

H 

td put count 

BF3TDRC 

DS 

H 

td purge count 

BF3TSGAC 

DS 

a 

ts get count 

BF3TSPAC 

DS 

a 

ts put aux count 

BF3TSPBC 

DS 

H 

ts put main count 

BF3BBBC 

DS 

H 

bms map count 

BF3BBIC 

DS 

H 

bms in count 

BF3BH0C 

DS 

a 

bms out count 

BF3BBZC 

DS 

H 

bms other count 

BF3SCBC 

DS 

H 

sc user get count 

BF3PCLIC 

DS 

a 

pc link count 

BF3PCXC 

DS 

a 

pc xctl count 

BF3PCL0C 

DS 

a 

pc load count 

MF3JCC 

DS 

a 

jc put/write count 

BF3ICC 

DS 

a 

ic put/initiate count 

BF3SPPC 

DS 

a 

sync point count 

BF3PGIC 

DS 

F 

page in count 

BF3SCHWB 

DS 

F 

storage high water mark 

BF3TCC 

DS 

F 

tc character count 

HF3TSN 

DS 

PL3 

task sequence number 

BF3TER 

DS 

X 

task exception record number 

BF32RR0R 

DS 

XL4 

task error flags 

BF30CNT 

DS 

F 

user count— may be multiple occurrences 

BF3BCLK 

DS 

CL6 

user clock— may be multiple occurrences 

BF3UFLD 

DS 

C 

user field 
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Global Sy stem Information 


HF3STRID 

DS 

CL4 

transaction identification.. 

MF3STEID 

DS 

CL 4 

terminal identification. 

MF3S0PID 

DS 

CL3 

operator identification. 

MF3STRTY 

DS 

C 

transaction type. 

MF3SIST 

DS 

XL8 

start of interval 

MF3SIET 

DS 

XL8 

end of interval 

MF3SUDT 

DS 

F 

user dispatched time 

MF3SUCP 

DS 

F 

user processor time 

MF3SUDC 

DS 

F 

user dispatch count 

MF3STCDT 

DS 

F 

tc dispatch time 

MF3STCCP 

DS 

F 

tc processor time 

MF3STCDC 

DS 

F 

tc dispatch count 

MF3SJCDT 

DS 

F 

jc dispatched time 

MF3SJCCP 

DS 

F 

jc processor time 

HF3SJCDC 

DS 

F 

jc dispatch count 

HF3SKCDT 

DS 

F 

kc dispatched time 

MF3SKCCP 

DS 

F 

kc processor time 

MF3SKCDC 

DS 

F 

kc dispatch count 

MF3SSRBT 

DS 

F 

srb time 

BF3SPGIH 

DS 

F 

page in count 

HF3SPG0U 

DS 

F 

page out count 

HF3SSHWM 

DS 

F 

dsa high water mark 

MF3SICV 

DS 

F 

icv 

HF3S0SCP 

DS 

XL4 

os wait processor 

MF3S0SWT 

DS 

CL6 

os wait time 

MF3SSIT 

DS 

CL2 

sit suffix 

MF3SMAXT 

DS 

PL2 

maxt 

MF3SAHXT 

DS 

fl 

amxt 

HF3STSD 

DS 

H 

terminal scan delay 

8F3SCNT 

DS 

PL2 

current no of tasks 


The KC , JC, TC system tasks collect data as they are used. This data is 
moved to the System information data fields at the time the information 
is to be written. 


Exception Class 


When a task exception condition has been completed, an exception record 
is created and sent to the CMP Exception blocking area. The number of 
exceptions associated with the task is incremented in the Performance 
class record (if Performance class is active). The Exception class 
record can be tied up with the Performance class record by the task 
number which is contained in both records. 


MF4TRID 

DS 

CL4 

transaction identification 

MF4TEID 

DS 

CL4 

terminal identification 

MF40PID 

DS 

CL3 

operator identification 

MF4TRTY 

DS 

C 

transaction type 

MF4TSN 

DS 

PL3 

task sequence number 

MF4TER 

DS 

X 

task exception record number 

MF4TST 

DS 

X14 

total amount of ts requested S waited 

MF4TSW 

DS 

CL6 

total time waiting for requested ts 

MF4STT 

DS 

X14 

total main storage requested but waited 

MF4STW 

DS 

CL 6 

total time waiting for main storage 

MF4VSTN 

DS 

CL8 

name of file waiting for VSAM string 

MF4VSTW 

DS 

CL6 

total wait time for this file 

MF4IS0N 

DS 

CL8 

name of file with ISAM overflow records 
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I User Data 

I 


| User data can be collected for both the performance and account classes, 
j The user data will appear at the end of the class record and the 
| dictionary will define the length of the user field. The number of 
| clocks and counters can be determined by analyzing the identifier string 
| that precedes the data. 


Values Contained In Class Record s 


Values are collected both at the entry to management modules and when a 
service is actually performed. The following is a list of fields that 
reflect the reguest for management services. 

MF3FCGC MF3FCPC MF3FCBC MF3FCDC MF3FCDC MF3FC0C 

MF3TDGC MF3TDPC MF3TDRC 

MF3TSGC MF3TSPAC MF3TSPMC 

MF3BMMC MF3BMIC MF3BM0C MF3BMZC 

MF3PCLIC MF3PCXC MF3PCL0C 

MF3JCC 

MF3ICC 

MF3SPPC 

Consequently, even if there is an invalid request, the counter is 
incremented. 

The following is a list of fields that are altered when a service is 
performed. 


MF2TRCT MF2TRAB MF2TRIM 
MF3SSHWM MF3SCUC MF3SCHWM 
MF3TAC 
MF3FCAMC 

Exception class — all fields : The requests for terminal dependent 
output services are collected and the actual completion of terminal 
dependent input is measured. 

MF3PINMC MF3P00MC MF3SINMC MF3S0UMC MF3TCC 

The clock MF3SUST measures the time spent on the suspend chain. 

The following system clocks are timed around the user tasks KC wait 
which are driven by the various CICS management modules. 

MF3TCWT MF3FCWT MF3JCWT MF3TSWT 

They include the time waiting to be redispatched after the I/O has 
completed which will depend on their position in the dispatching chain. 

During an elapsed period,one of the following states will exist. 

1. User task in control (includes JC and TC tasks). 

2. KC task in control 

3. CICS/VS has issued an operating system or supervisor wait. 
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I The following clocks will reflect the time spent in these states. 

| MF3SUDT MF3STCDT HF3SJCDT MF3KCDT MF3S0SWT MF3DIST 

| If the CPU option on the 1 DFHMCT TYPE=SMP,CLASS=PERFORM• has been 
| specified then the following times represent the amount of time within 
j these elapsed times that the CICS region had control. 

| MF3SUCP MFSTCCP MF3SJCCP MF3SKCCP MF3S0SCP MF3CPUT 

| The clock MF3SSRBT measures SRB time that cannot be allocated to a task 
| in the normal way. 

| Paging information is collected in the following fields when the CPU 
| option has been specified* 

| MF3SPGIN MF3SPG0U MF3PGIC 

| On VSE this information is for the whole system, otherwise it relates to 
I the partition or address space. It specifies the number of page—ins and 
j page-outs for the elapsed period. 


I PHYSICAL DESCRIPTION OF SMF FO RM AT DATA 

I 

| This section will deal with how the information described previously 
| appears on the monitor dataset. 

| Each SHF record occupies one physical block, the format of which is : 
| LLBB.SMF-HEADER.PRODUCT-SECTION.CICS-SECTION.ClCS-SECTION 
| The ”CICS—SECTION” may occur many times. 


| SMF Heade r 

I 

| This describes which system wrote the information to the log. 



SMFFLG 

DS 

X 

system indicator 


SMFFLVS1 

EQU 

X • 81 • 



SMFFLVS2 

EQU 

X • 82* 



SMFFLDOS 

EQU 

X*84 • 



SMFRTY 

DC 

X *6E * 

record 110 for CICS/VS 


SMFTME 

DS 

F 

time record moved to smf buffer 


SMFDTE 

DS 

F 

date record moved to smf buffer 


SMFSID 

DS 

C14 

system identification 


SMFSSS 

DS 

C14 

subsystem id 



DS 

H 

reserved 


SMFAPS 

DS 

S14 

offset to product section (pssul 


SMFLPS 

DS 

H 

length of product section 


SMFNPS 

DS 

H 

number of product sections 


I 

| This area is mapped by the macro DFHJCSMF. 
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I P roduct Section 

I 

| SMFPSSTY DS H 

| SMFPSRVR DS H 

| SMFPSPRN DS C18 

| SMFPSRSN DS P14 

| SHFPSJID DS X 

I 

| This area is mapped by 


sub type. CICS/VS uses type = 1 
record version. CICS/VS uses type=1 
product name (APPLID) 
record seguence number in this log 
journal log identification 

the macro DFHJCSMF. 


CICS/VS Section 


Each CICS/VS section has the following format: 
Section Header.Section Descriptor.Section Data 
or 


Section Header.Section Descriptor.Section Dictionary 

The ‘'Section Header” will identify the system that is being written 
about and the class of recording. 



DS 

F 

length (CICS/VS Section) in LLBB 

format 

SEGL 

DS 

H 

length of Section Header 


MNSEGCL 

DS 

H 

class of data capture 


ACCOUNT 

EQ0 

2 

accounting class 


PERFORM 

BQU 

3 

performance monitoring class 


EXCEPT 

BQU 

4 

task exception class 


MNSEGSYS 

DS 

C18 

sub system name — APPLID 


MNSEGID 

DS 

Cl 4 

machine on which data was produced — CICS/VS 

MNSEGREG 

DS 

H 

reserved 


The «Section 

Header” 

(except the LLBB length and 'segl* ) 

is mapped by 


the macro DFHCMPRC PREFIX. 


Section Descriptor 


This sub division defines the type of record. Some classes of recording 
have several types. A record type of 0 for a class is the class 
dictionary. 


The section descriptor also defines the number of rows and columns of 
data in the ”Section Data” or ‘'Section Dictionary”, A row of 
information is one record that has been collected by monitoring. Many 
columns make up a row. The identifiers (one per column) define the 
contents of each row. It can be seen that the length of each row in the 
"Section Data” is identical (MCTSSDRL). 


MCTSSDL DS 
MCTSSDID DS 
MCTSSDCA DC 
MCTSSDCL DC 
MCTSSDCN DC 
MCTSSDRA DC 
MCTSSDRL DC 
MCTSSDRN DS 


H 1*section descriptor*+1*section data* 

H type of record 

Y (SSDIDSA—MCTSSD1) column descriptors address 

H (1) column descriptors length 

Y(SSDIDEA—SSDIDSA) column descriptors(number of) 

Y(SSDDRSA—MCTSSD1) data row address 

Y (SSDDREA—SSDDRSA) data row length 

H data row (number of) 
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| This area is mapped by the DFBMCTSS macro 


Section Data 


This area contains the information collected by monitoring about the 
resources used by tasks. The ••identifier' 1 is used to search the 
dictionary. (The dictionary will define the length of the data in the 
record as well as the type of data. It also contains the description of 
the information) • 


SSDIDSA 

DS 

OB 

start address of identifiers 

SSDID1 

DS 

X 

first identifier 

SSDID2 

DS 

X 

second identifier 

SSDIDI 

DS 

X 

ith identifier 

SSDIDN 

DS 

X 

nth identifier 

SSDIDEA 

DS 

OX 

end address of identifiers 

SSDDRSA 

DS 

OX 

start address of data row 

SSDDR1 

DS 


data for identifierl 

SSDDR2 

DS 


data for identifier 2 

SSDDRI 

DS 


data for identifier i 

SSDDRN 

DS 


data for identifier n 

SSDDREA 

DS 

OX 

end address of data row 


then there are repeats of the row data as specified by SSDDRN. 


SSDDRSA 

DS 

OX 

start address of next data row 

SSDDRI 

DS 


data for identifierl 

SSDDR2 

DS 


data for identifier 2 

SSDDRI 

DS 


data for identifier i 

SSDDRN 

DS 


data for identifier n 

SSDDREA 

DS 

OX 

end address of data row 


Section Dictionary 


Each identifier in the Section Data will refer to the Section 
Dictionary. The dictionary will be sent to the dataset each time that a 
class of monitoring is turned on. The reason it is sent frequently is 
to ensure that the post processing programs know the meaning of the data 
that they receive. There will be one data dictionary for each class of 
recording. 

The postprocessing program will arrange to store the most recent 
dictionary on a dataset so it can be used when there is no dictionary 
available. This can occur on continuation volumes of datasets. 

The data structure used for the Section Data will be used for the 
dictionary definition. 

The field between SSDIDSA and SSDIDEA is null for dictionaries. 

(That is no identifiers) The fields between SSDDRSA & SSDDREA have a 
format that is defined in the “Dictionary Structure 11 section. 
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MCTSSDL 

DS 

H 

MCTSSDID 

DC 

H (0) 

MCTSSDCA 

DC 

Y 

HCTSSDCL 

DC 

H(2) 

MCTSSDCN 

DC 

Y 

MCTSSDRA 

DC 

Y 

MCTSSDRL 

DC 

H(-1) 

MCTSSDRN 

DC 

Y (0) 

SSDDRSA 

DS 

OH 


dictionary 

start address of list 
address lengths 
no of dictionary entries 
start address of data 
variable length data 
unused 

start address of data 


<id> <data type> <data length> <head len> <head text>.. each entry 


SSDDREA DS OH 


end address of data 


Example of Happing a SMF Record with One CICS/VS Section 


*+2 

*+2 


DS X14 

DFHJCSMF 
DS X14 

DS X12 

DFHCMPRC prefix 


11bb of smf record 

llbb of CICS/VS section 
length of section header 


DFHHCTSS 

ORG MCTSSIDA start of section data 

now the identifiers follow 


these are followed by the data 


D ictionary Structure 

The dictionary defines the identifier which represents a particular 
field. There is a separate dictionary for each monitoring class. 

The format of the dictionary entry is: 

Data Identifier.Data Type.Data Length.Head Length.Heading 

where : 

Data Identifier is a number in the range 0—255 

Data Type states whether field is packed, binary, character,or tod 

Data Length defines the number of bytes in the data stream 
belonging to this identifier 

Head Length is the length of the heading 

Heading is the string that appears above the columns in the printed 
version 
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The information in a CICS/VS Section refers to one class of monitoring. 
The identifiers appear at the beginning of a Data Section. At task 
termination, monitoring completes the task detail record and appends it 
to other task detail records. The format of a Data Section is: 

List of Identifiers.Detail Record for Task 1.Detail Record for task n 

As monitoring records are completed, they are appended to the current 
contents of the Data Section. The structure of each record in a Data 
Section is identical, they are all defined by the list of identifiers 
appearing at the start of the Data Section. 

Thus the first identifier will define the length and meaning of the 
first field. Subsequent identifiers define subsequent fields. There 
are an equal number of identifiers and fields in the record. The user 
counts and clocks which may appear many times will have many occurrences 
of the identifiers representing counts and clocks. 

Example: 

The transaction ABCD run at terminal EFGH by operator JKL was started 
at the terminal and only wrote one message back to the terminal (at end 
of task)• In this session, this operator entered this transaction 10 
times, one of which ended abnormally. The user count facility was not 
used by this transaction. The sequence of identifiers would be: 

1 2 3 4 5 6 7 8 

and the record fields would be: 

ABCD | EFGH | JKL | T | 10 | 1 | 10 | 0 
A block of accounting records would appear as follows: 

String of Identifiers.Data for Tran 1....Data for Tran n 
This block will become part of a Section Segment Data record. 
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A pp e ndix A. R e quir e d Entries in CICS/VS Control Tables 


This appendix describes the entries that are specially treated in the 
following CICS/VS control tables: 

• Destination control table (DCT) 

• Program control table (PCT) 

• Processing program table (PPT) 


DESTINATION CONTROL TABLE 


| CSMT, CSTL, and CSSL must be specified by the user in the DFHDCT 
| TYPE=EXTRA, DFHDCT TYPE=INTRA, or DFHDCT TYPE=INDIRECT macros. CSSH and 
| CSSN must be specified in the DFHDCT TYPE=EXTRA macro with OPEN=DEFERRED 
| and must be defined as nonresident with suffixes of SM and SN 
j respectively. 

| Destinations CSHL and CSCS (for the sign-on program) are optional. 


I 


1. DESTID=CSHT The terminal abnormal condition program (DFHTACP), 

node abnormal condition program (DFHZNAC), 
and abnormal condition program (DFHACP) write 
terminal error and ABEND messages, respectively, 
to this destination. 

2. DBSTID=CSTL DFHTACP writes terminal I/O error messages to 

this destination. 

3. DESTID=CSSL Statistics programs write data to this 

destination. 


4. DESTID=CSSM The automatic statistics program writes data 

DESTID=CSSN to these destinations. The automatic statistics 
program requires that the CSSM and CSSN DCT 
entries are specified in DFHDCT !YPE=EXTRA, 
with a final destination of either a tape 
or a disk device. 


| 5. DESTID=CSML Sign-off program outputs data to this 

I destination. 


| 6. DESTID=CSCS 


Receives messages from the sign-on program, 

which contain details of every sign-on, 

sign-off, or rejected attempt at signing on. 

Destination CSCS can be of any type 

and a logical record length of 125 bytes 

will be adequate. The actual length is 63 bytes but 

message types might change this. 


Note ; The above entries may not be specified, either directly or 
| indirectly, as logically or physically recoverable intrapartition 
| destinations. These destinations must always be enabled. If any are 
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defined as indirect destinations# their final target destination must 
also always be enabled. 

The destinations CSMT# CSTL# CSSL# and CSML require a minimum logical 
| record size of 128. The destinations CSSM and CSSN require a minimum 
logical record size of 304. These entries are only required when the 
| automatic statistics program is to be used and they should have 
| RECFORM=VARBLK specified in DFHDCT TYPE=SDSCI. 

Only CSSM is required if no switching is to be done between the 
statistics data sets. If the transient data control program (DFHTDP) is 
not included in the generation of CICS/VS# messages to these 
destinations are ignored. 

The entry for CSSM should read: 


DFHDCT TYPE=EXTRA#DESTID=CSSM, * 

DSCNAME=DFHSTM # * 

OPEN=DEFERRBD# * 

| RESIDENT=NO 

and must be preceded by: 

DFHDCT TYPE=SDSCI#DSCNAHE=DFHSTN# * 

BLKSIZE=, * 

RECSIZB= # * 

| RECFORM=VARBLK, * 

| SUFFIX=SM# * 

TYPEFLE=0UTPUT 


The entry for CSSN should read: 


DFHDCT TYPE=EXTR A# DESTID=CSSN, * 

DSCNAME^DFHSTN# * 

OPEN=DEFERRED # * 

| RESIDENT=NO 

and must be preceded by: 

DFHDCT TYPE=SDSCI#DSCNAME=DFHSTN# * 

BLKSIZB=# * 

| RECSIZE=VARBLK # * 

RECFORH=# * 

| SUFFIX=SN # * 

TYPEFLE=0UTPUT 


Note : If these DSCNAMEs (DFHSTM and DFHSTN) are used# an MNOTE message 

('•DSCNAME SHOULD NOT USB ”DFH” PREFIX”) will be issued. This message 
can be ignored. 

| Refer to the CICS/VS—supplied pregenerated versions of the DFHDCT 
| macros for typical values to be specified for these operands. 

If the PL/I Optimizer—supplied PL/I—CICS/VS support is to be 
installed# destinations CPLI (SYSPRT output) and CPLD (PLIDUMP output) 
will also be required. The minimum logical record size for CPLI is 133# 
and 125 for CPLD. If the destinations are extrapartition (direct or 
indirect)# they must be V format. See the PL/I Optimizer Installation 
H anua l for further details. 
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B-B0S&AJ1COimtDX TABLE 


The following entries for CICS/VS-supplied transaction names may be 
required in the PCT depending on the particular CICS/VS system generated 
and can be provided through the DFHPCT TYPE=ENTRY macro instruction if 
the system programmer wishes to override the entries that are provided 
by the PN operand of the DFHPCT TYPE=GROUP macro. 


TRANSID* 

PROGRAM 

FUNCTION 

GROUP 

CLASS 

TPURGE/ 

SPURGE 

TWASIZE 

TRANSEC 

See Notes 
Below 

CAQP 

DFHAQP 

ATP 

SHORT 

NO/NO 

100 



CATP 

DFHATP 

ATP 

LONG 

NO/NO 

200 



CAUT 

DFHSTSP 

AUTOSTAT 

SHORT 

NO/NO 

100 



CCMF 

DFHCCMF 

STANDARD 

SHORT 

YES/YES 

20 



CECI 

DFHECIP 

INTERPRETER 

LONG 

NO/NO 

0 

INTERPRETER 

CECS 

DFHECSP 

INTERPRETER 

LONG 

NO/NO 

0 



CEDP 

DFHEDFP 

EDF 

LONG 

NO/NO 

152 

EDF 


CEMT 

DFHEMTP 

OPERATORS 

LONG 

NO/NO 

200 

MASTER 

8 

CBOT 

DFHEOTP 

OPERATORS 

LONG 

YES/YES 

200 


8 

CEST 

DFHESTP 

OPERATORS 

LONG 

YES/YES 

200 

SVR 

8 

CMPX 

DFHMXP 

ISC 

LONG 

YES/NO 

0 



CMSG 

DFHMSP 

MSWITCH 

SHORT 

YES/YES 

512 


4 

CRDR 

DFHRD1 

ATP 

LONG 

NO/NO 

100 



CRSQ 

DFHCRQ 

ISC 

SHORT 

YES/YES 

0 



CRSR 

DFHCRS 

ISC 

SHORT 

NO/NO 

0 


16 

CRTE 

DFHRTE 

ISC 

LONG 

NO/NO 

0 

ROUTING 


CSAC 

DFHACP 

STANDARD 

SHORT 

NO/NO 

40 


7,8 

CSCE 

DFHZCNC 

CONSOLE 

SHORT 

NO/NO 

0 


(OS/VS only) 

CSCY 

DFHCPY 

VTAMPRT 

SHORT 

YES/YES 

16 


11,12 

CSFE 

DFHFEP 

FE 

LONG 

YES/YES 

100 

FE 

8 

CSFR 

DFHFED 1 

FE 

LONG 

YES/YES 

352 

FE 

8 (VSE only) 

CSGM 

DFHGMM 

VTAM 

SHORT 

YES/YES 

0 



CSIR 

DFHCRR 

ISC 

SHORT 

NO/NO 

0 



CSJC 

DFHJCBSP 

JOURNAL 

LONG 

NO/NO 

0 



CSKP 

DFHAKP 

AKP 

SHORT 

NO/NO 

0 



CSLG 

DFHZRLG 

RESPLOG 

LONG 

NO/NO 

0 


8,10 

CSMI 

DFHMIR 

ISC 

LONG 

YES/NO 

0 

MIRROR 

14,15 

CSMT 

DFHMTPA 

MASTTERM 

LONG 

NO/NO 

200 

MASTER 

8,9 

CSNC 

DFHCRNP 

ISC 

LONG 

NO/NO 

256 


13 

CSNE 

DFHZNAC 

VTAM 

SHORT 

NO/NO 

540 


5 

CSOT 

DFHMTPA 

MASTTERM 

LONG 

YES/YES 

200 


8,9 

CSPG 

DFHTPR 

BMS/MSWITCH 

SHORT 

NO/NO 

640 



CSPK 

DFHPRK 

VTAMPRT 

SHORT 

YES/YES 

16 


11,12 

CSPP 

DFHP3270 

HARDCOPY 

SHORT 

YES/YES 

100 


11,12 

CSPQ 

DFHTPQ 

BMS/MSWITCH 

SHORT 

NO/NO 

256 



CSPS 

DFHTPS 

BMS/M SWITCH 

SHORT 

NO/NO 

256 



CSRK 

DFHRK8 

VTAMPRT 

SHORT 

YES/YES 

0 



CSRS 

DFHZRSP 

RESEND 

LONG 

NO/NO 

8 


6,10 

CSSF 

DFHSNP 

SIGNON 

SHORT 

YES/YES 

0 


7,8 

CSSN 

DFHSNP 

SIGNON 

SHORT 

YES/YES 

0 


7,8 

CSST 

DFHMTPA 

MASTTERM 

LONG 

YES/YES 

200 

SVR 

8,9 

CSTA 

DFHTAJP 

TIME 

SHORT 

YES/YES 

0 


8 

CSTE 

DFHTACP 

STANDARD 

LONG 

NO/NO 

352 



CSTT 

DFHSTKC 

STANDARD 

LONG 

NO/NO 

200 


8,9 

CSXX 







2 

CWTO 

DFHCWTO 

CONSOLE 

LONG 

YBS/YES 

0 


(VSE only) 

CWTR 

DFHWT1 

ATP 

LONG 

NO/NO 

200 



8888 

DFHSNP 

NUMERICS 

SHORT 

YES/YES 

0 


1 

9999 

DFHSNP 

NUMERICS 

SHORT 

YES/YES 

0 


1 

Key—id 

DFHEDFP 

EDF 

LONG 

NO/NO 

0 

EDF 

17 


User—name User- 

supplied 3 
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Certain transactions beginning with the characters #I CSD M may be required 
| if the system is running with DL/I under VSE. Refer to the DL/I 
publications for details of these transactions. 

Notes ; (see foregoing table) 


* The TWASIZE need not be specified for the system transactions listed 
above. DFHPCT will automatically supply the minimum TWASIZE 
necessary for the transaction. A value need only be specified if 
extra private space is required. 

1. Entries are only required when numeric-only terminals are used to 
sign on. 

2. Transaction code CSXX is reserved for 3270 support and should not 
be generated in the PCT. It is used by CICS/VS to generate an 
••invalid transaction code” message when a zero length data message 
is received. 

3. Any transaction codes specified for the TRANSID parameter in any 
DFHTCT TYPE=TERMINAL macro instruction must be included in the PCT. 

4. The TRANSID for CICS/VS message switching program (DFHMSP) can be 
CMSG or any four character code chosen by the user to replace CMSG, 

| in which case, a TWASIZE of at least 512 bytes must be specified. 

FN=MSWITCH also generates the BMS group of transaction 
identifications. 

5. The CICS/VS—supplied TWASIZE for CSNE is a minimum. It must ne 

| increased for any user requirements in DFHZNEP. (For CICS/OS/VS 

| the minimum TWASIZE is 584 bytes.) 

6. The TWASIZE for CSRS may ne increased by user requirements. 

7. For transaction codes CSAC, CSSN, and CSSF, the value of the user- 
assigned transaction security key must be 1. 

| 8. For transaction codes CEMT, CEOT, CEST, CSAC, CSFE, CSFR, CSJC, 

I CSLG, CSMT, CSNC, CSOT, CSST, and CSTA, a high priority (such as 

255) is recommended. For transaction codes CSSF, CSSN, and CSTT, a 
low priority (such as 1) is recommended. These priorities are set 
automatically by the appropriate DFHPCT TYPE=GROUP macros. 

9. Transaction codes CSMT, CSOT, CSST and CSTT, cannot be used in 2260 
compatibility mode; specify COMPAT=NO or omit the operand. 

10. Transaction codes CSNE, CSLG, and CSRS, must be defined as VTAM— 
only transactions (DVSUPRT=VTAM in DFHPCT macro). 

11. When purged, a message could be lost. 

12. CSPP is required for hard copy support (PRINT=PA1, PA2, PA3, or YES 
in DFHSIT) for VTAM and BTAM 3270. CSCY, CSPK, and CSRK are 
required for PRINT=PA1, PA2, or PA3 for VTAM 3270. CSPK is 
reguired for 3270 compatibility mode. 

| 13. TRANSID=CSNC is only required for DL/I shared data base support 

j (CICS/OS/VS only) or the use of the multiregion operation (MRO) 

facility • 

14. Transaction code CSMI provides the CICS/VS mirror module for inter 
communication support, the MRO facility, and (for CICS/OS/VS only) 
DL/I shared data base support. 
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15. Transaction, code CJS.MLI requires INBPttH=ALL in its DFHPCT TYPE=ENTRY 
statement. This parameter is provided when FN=ISC is specifiedin 
DFHPCT TYPE=GROUP. 

16. INBFMH=ALL mast be specified in DFHPCT TYPE=ENTRY if transaction 
codes CSPS (if transaction routing is being used) and CRSR are 
reguired. This parameter is provided when FN=ISC is specified in 
DFHPCT TYPE=GROUP• 

17. Valid key—ids are PF1 through PF24. It is anticipated that a 
security key would be specified for this entry. 


PROGRAM CONTROL TABLE (ADDITIONAL FEATURES) 

The following entries are reguired if dedicated PA and/or PF keys are 
used with the single keystroke retrieval feature of BMS, that is, if the 
extended option for single keystroke retrieval is used. 


TASKREQ 

PROGRAM 

TWASIZE 

CLASS 

TPURGE/SPURGE 

key—id 

DFHTPR 

640 

SHORT 

NO/NO 

The valid 

key—ids ate 

PA1 through 

PA3 and 

PP1 through PF24 


PROCESSING PROGRAM TABLE 


The following entries have special significance in the PPT and can be 
provided through the DFHPPT TYPE=ENTRY macro instruction if the system 
programmer wishes to override the entries that are provided by the 
| DFHPPT TYPE=GRODP macro. The STANDARD group should always be included, 
j and other groups included only if required by the installation. 


PROGRAM 

NAME 

FUNCTION 

GROUP 

USAGE 

DFHACP 

STANDARD 

Abnormal condition program. 

DFHAKP 

AKP 

Activity keypoint program for recovery/restart. 

DFHAQP 

ATP 

Asynchronous queue purge program (required only 
if the asynchronous transaction processing 
facility is being used). 

DFHATP 

ATP 

Asynchronous transaction control program 
(required only if the asynchronous transaction 
processing facility is being used). 

DFHBMSMM 


Basic mapping support program (required only if 
programs or maps from a previous version of CICS 
are still being used). If these programs and 
maps are recompiled and linked under CICS/VS, 
DFHBMSMM is not required. 

DFHCCMF 

DFHCMON 

STANDARD 

Periodic monitoring program. 

Start/stop monitoring program. 
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DFHCPI 

DFHBXI 

DFHPRK 

DFHRKB 


| DFHCRNP 
| DF9CRSP 
I 
I 

| DFHCRR 
| DFHCRS 
| DFHCRP 
| DFHRTE 
| DFHCRQ 
I DFHMXP 

DFHCWTO 

| DFHZCNC 

DFHDBPxx 


I 

I 

| DFHBCIP 
I DFHECSP 
| DFHECID 

DFHBDFD 

DFHEDFF 

DFHEDFM 

DFHEDFP 

DFHEDFR 

DFHEDFX 

| DFHEMTP 
| DFHESTP 
| DFHEOTP 
| DFHEMTD 
| DFHEMA 
| DFHEMB 
I 

| DFHEMC 
| DFHEMD 
| DFHEMB 
DFHEMF 
DFHEMG 

| DFBFELG 
DFHFEP 
I DFHFERR 
DFHFED1 
DFHFED2 
DFHFBTX 

DFHGMM 


VTAMPRT 


ISC 


CONSOLE 


BACKOUT 


Terminal Control Print Key Support programs 
(required only if DFHSG PROGRAM=TCP, 

VTAMDEV=3270, DFHSIT PRINT=PA1, PA2 r or PA3, 
or 3270 compatibility mode are specified). These 
are part of the support generated when 
VTAMDEV=3790 or LUTYPE2 is specified. 

Interregion new connection manager 
and interregion control initialization program 
(DL/I shared data base support (CICS/OS/VS only) 
or MRO) . 

IRC session recovery program. 

Remote scheduler program. 

Transaction routing relay program. 

Transaction routing program. 

ATI purge program. 

Local queuing shipper program 

Terminal to processor console terminal message 
switching program (CICS/DOS/VS only). 

Console write to operator program (CICS/OS/VS only). 

Dynamic transaction backout program. A PPT 
entry must correspond to the DBP=xx entry in 
DFHSIT. DFHPPT TYPE=GROUP,FN=BACROUT will produce 
both the pregenerated versions of the program 
(DFHDBP1S and DFHDBP2S). 


INTERPRETER CECI initialization. 

CECS initialization. 

Command interpreter. 

EDF Execution (command level) diagnostic facility 

(EDF) display program (when EDF is desired) • 
EDF function description table. 

EDF map set. 

EDF control program. 

EDF response table. 

EDF task switch program. 


OPERATORS CENT initialization. 

CEST initialization. 

CEOT initialization. 

Enhanced master terminal. 

Task values, BATCH, RESET. 

VTAM, DUMP, IRC, AUXTRACE, TRACE, PTR, SNAP, 

SHUTDOWN. 

TERMINAL, NETNAME. 

DATASET. 

TRANSACTION, TASK. 

PROGRAM, QUEUE. 

CONTROL, LINE. 

FE FERS error logging program (BTAM & CICS/DOS/VS). 

Terminal test program (optional). 

FERS record reorganization program (CICS/DOS/VS only) 
FERS display program (CICS/DOS/VS only)• 

FERS display program (CICS/DOS/VS only) • 

FERS text display program (CICS/DOS/VS only). 

VTAM CICS/VS VTAM # good morning* message program. 
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DFdJCBSP 

DFHJCC 

DFHJCBOV 

DFHJCI 

DFHJCIOE 

DFHJCKOJ 

DFHJCO 

DFHJCSDJ 

JOURNAL 

Journal tasks •boot strap 1 program. 

Journal control close program. 

Journal control EOV program. 

Journal control input program. 

Journal control I/O error program. 

Kick-off journal control program. 

Journal control open program. 

Shutdown journal control program. 

DFHMIR 

ISC 

Intercommunication and DL/I shared data base 
{OS/VS only) mirror program. 

DFHMSP 

MSWITCB 

Message switching program (only required 
if message switching is being used)• 

DFHMTPA 

DFHMTPB 

DFHMTPC 

DFHMTPD 

DFBMTPE 

DFHKTPF 

DFHMTPG 

MASTTERM 

Master terminal program (only required if master 
terminal or system termination functions are 
desired) . 

DFHOCP 

OPENCLSE 

Dynamic open/close program (only required if 
dynamic open/close facility is desired) . 

DFBPEP 


Program error program linked to by DFHACP• 

This can be the dummy program error program, 
user-written program error program, or can 
be omitted entirely. 

DFHPLTxx 

— 

An entry for each program list table generated 
by the user with the DFHPLT macro instruction. 

DFHP3270 

HARDCOPY 

Terminal control program print application program 
Required if DFHSIT,PRINT=YES, PA 1, 

PA2, or PA3 is specified. 

DFHRD1 

DFHRD2 

ATP 

Asynchronous transaction input processing 
programs (only required if the asynchronous 
transaction processing facility is being used). 

DFHRTY 


Transaction restart, for use with the 
dynamic transaction backout facility. 

This can be user—written, the CICS/VS-supplied 
sample version, or can be omitted. 

DFHRUP 

RECOVERY 

Recovery utility program for recovery/restart. 

DFHSFP 

SIGNON 

Sign-off program linked to by DHFSNP (only 
required if sign—on/sign—off function is desired). 

DFBSNET 

— 

VTAM sample node error table. 

DFHSNP 

SIGNON 

Sign—on program (only required if sign—on/sign— 
off function is desired). 

DFHSNT 

SIGNON 

Sign—on table (only required if sign—on/sign—off 
function is desired). 

DFHSTKC 

STANDARD 

Supervisor statistics program. 

DFHSTLK 

STANDARD 

ISC Link statistics program. 

DFHSTP 

STANDARD 

System termination program linked to by DFHMTP• 
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DFHSTPD 

STANDARD 

Program and dump statistics program linked to 
by DFHSTKC• 

DFHSTSP 

AUTGSTAT 

Automatic statistics summarization control program. 

DFHSTTD 

STANDARD 

Data management statistics program linked to by 
DFHSTKC. 

DFHSTTR 

STANDARD 

File and terminal statistics program linked 
to by DFHSTKC. 

DFHTACP 

STANDARD 

Terminal abnormal condition program. 

DFHTAJP 

TIME 

Time adjustment program that automatically adjusts 
the date and time of day maintained by CICS/VS 
to reflect the date and time of day maintained by 
the operating system. 

DFHTBP 

RECOVERY 

Transaction backout program. 

DFHTDRP 

RECOVERY 

Transient data recovery program for recovery/restart. 

DFHTBP 

STANDARD 

Terminal error program linked to by DFHTACP. 

This can be the dummy terminal error program 
provided during the generation of the control 
system operational group, a generated version of 
the sample terminal error program provided with 
CICS/VS, or a user-written terminal error program. 

DFHTBPT 


Terminal error program table (only required if 
a generated version of the sample terminal error 
program provided with CICS/VS is used). RES=YES 
should be specified in the PPT entry for DFHTBPT. 

DFHTLTxx 

— 

An entry for each terminal list table generated 
by the user with the DFHTLT macro instruction. 

DFHTPQ 

MSWITCH 
or BMS 

Basic mapping support program (only required 
if CICS/VS basic mapping support is being used). 

DFHTPR 

MSWITCH 
or BMS 

Basic mapping support program (only required if 
CICS/VS basic mapping support is being used). 

DFHTPS 

MSWITCH 
or BMS 

Basic mapping support program (only required if 
CICS/VS basic mapping support is being used)„ 

DFHTRNxx 

—. 

Nonresident data set control blocks as specified 
by the user in DCT• (Specify RELOAD=YES for each.) 

DFHTSRP 

RECOVERY 

Temporary storage recovery program. 

DFHUAKP 

"" 

User Activity Keypoint Program linked to by 

DFHAKP. This can be a user-supplied program 
or can be omitted entirely. 

DFHWT1 

DFHWT2 

ATP 

Asynchronous transaction output processing 
programs (only required if the asynchronous 
transaction processing facility is being used). 

DFHXITxx 

— 

User—written exit routine used with asynchronous 
transaction processing transactions CRDR and CWTR. 

DFHXLTxx 

— 

An entry, for each transaction list table generated 
by the user with the DFHXLT macro instruction. 
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DPHZNAC VTAM Node abnormal condition program. 

DFHZNEP VTAM Node error program linked to by DFHZNAC. This is 

either the interface module generated by the 
DFHZNEPI macro, or the only user—written node 
error program. 

DFHZRLG RESPLOG Response logging program. Required for VTAM. 

DFHZRSP RESEND Resend program. Required for VTAM support if 


message resynchronization requires retransmission 
of any in—doubt committed output message (See 
••Message Recovery and Resynchronization” in 
Chapter 4.8.) . 

User— — User—written program to edit input data and 

specified transfer control to the appropriate transaction, 

name 


User— — The names of any recovery programs from the 

specified system recovery table. 

name 


User— 

specified 

name 


User- 

specified 

name 


An entry is required for each mapset name for 
for input and output basic mapping support 
operations. The RELOAD=YES option of the PPT 
must not be used with BHS maps. 

An entry is required for each user node error 
program as specified by the DFHZNEP module 
generated by the DFHZNEPI macro. 


The following entries are required if the PL/I Optimizer-supplied 
PL/I-CICS/VS support is to be installed. See the PL/I Optimizin g 
Compiler; Installatio n manual for details. 


IBMBCCLA, IBMBCCRA (OS/VS only), IBMBEOCA, IBMBETAA, IBMBETBA, IBMBETCA, 
| IBMBETIA, IBMBETOA, IBMBETPA, IBMBETQA, IBMBETTA, IBMDCCRA (VSE only), 
IBMFEFCA, IBMFESMA, IBMFESNA, IBMFKCSA, IBMFKMRA, IBMFKPTA, IBMFKTBA, 
IBMFKTCA, IBMFKTRA, IBMFPGDA, IBMFPMRA, IBMFSTVA• 

These entries may be generated as a functional group through the 
FN=PL/I operand of DFHPPT TYPB=GROUP. 

Records to define such entries are provided as part of the PL/I 
installation information. 


| The following module is required if EDF is to be used with 
| applications containing EXEC DLI commands. 

I 

| DLZHLPI Language definition table for DL/I HLPI language. 
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Appendix B. Examples of Terminal Control Table 
Preparation 


This section illustrates the coding required to prepare the CICS/VS 
terainal control table (TCT). The terminal network described includes: 

1. Start/stop transmission 

a. Multipoint line (serving one or more terminals) 

(1) 1050 Data Communication System under CICS/DOS/VS 

(2) 2260 Display Station (Remote) under CICS/T>OS/VS 

b. Point—to—point line (serving only one terainal) 

(1) 2740 Communication Terminal under CICS/DOS/VS 

(2) 2741 Communication Terminal with correspondence code 
under CICS/DOS/VS 

c. Switched line (dial-up) 

(1) 7770 Audio Response Unit under CICS/OS/VS via local 
attachment 

(2) 7770 Audio Response Unit under CICS/DOS/VS via local 
attachment 

(3) Teletypewriter Exchange Terminal (CPT—TWX) under 
CICS/DOS/VS 

(4) Teletypewriter (WTC only) under CICS/DOS/VS 

2. Binary synchronous transmission 

a. Multipoint line (serving one or more terminals) 

(1) 2980 General Banking Terminal System under CICS/OS/VS 

(2) 3270 Information Display System (remote) under CICS/OS/VS 

(3) 3740 Data Entry System under CICS/DOS/VS 

(4) 3780 Data Communication Terminal under CICS/OS/VS 

(5) 3600 Finance Communication System under CICS/OS/VS 

b. Point—to—point (serving only one terminal) 

• 2780 Data Transmission Terminal 

c. Switched line (dial-up) 

(1) 2770 Data Communication System under CICS/OS/VS 

(2) System/3 under CICS/OS/VS 

(3) 3275 Display Station under CICS/DOS/VS 

(4) 3735 Programmable Buffered Terminal under CICS/OS/VS 

(5) 3740 Data Entry System under CICS/DOS/VS 

(6) 3740 Data Entry System under CICS/OS/VS 

3. Transmission via sequential devices under CICS/DOS/VS 

a. Card reader/line printer 

• 2540 Card Read Punch and 1403 Printer 

b. Disk 

• 2314 Direct Access Storage Facility 

c. Processor console as a terminal 

4. Transmission via devices locally attached 

| a. Display devices 

(1) 3270 Information Display System (local) under CICS/OS/VS 

(2) 2260 Display Station (local) under CICS/DOS/VS 

5. SDLC /SNA terminals 

Examples of TCT generation for terminals connected via VTAH 

6. Additional examples for terminals connected via TCAM. 

| 7. Intercommunication (ISC and MRO) 

8. DL/I Shared Data Base Support (CICS/OS/VS) 
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9. DFHTCT TYPE=GPENTBY Macro (Local and Beaote 3270s under CICS/DOS/VS) 


Each of the following is a functional example if, (1) the DFHTCT 
TYPE=INITIAL macro instruction is inserted at the beginning of each 
example, (2) the DFHTCT TYPE=FINAL macro instruction is inserted at the 
end of each example. 


1050 DATA COMMUNICATION SYSTEM (MULTIPOINT DHDEB CICS/P0S/7S1 

DFHTCT TYPE=SDSCI, * 

DEVICE=1050, * 

LINELST=(030), * 

DSCNAME=DTF50MD, * 

C0=2703, * 

SWITCH=N0 

OPL1050 DFTEMLST OPENLST,(620B,620D,640B) 

DFHTCT TYPE=LINE, * 

ACCMETH=BTAM, * 

TBMTYPE=1Q50, * 

DSCNAME=DTF50MD, * 

INABEAL=80, * 

BTAMBLN=1, * 

LISTADB=OPL1050 

DFHTCT TYPE=TEBMINAL, * 

TBMIDNT=T50A, * 

TBMPETY=10, MOD 5 INDICATES KEYBOABD * 

TBMMODL=5, * 

TBMTYPE=1050, * 

TB MADDK=6202, * 

TBMSTAT=TBANSCEIVE 

DFHTCT TYPE=TEBMINAL, * 

TBMIDNT=T56A, * 

TBMPBTY=10, * 

TEMMODL=6, MOD 6 INDICATES 1056 BEADEB * 

TBMTYPE=1050, * 

TEMADDB=6202, * 

TBMSTAT=TBANSCEIVE 

DFHTCT TYPE=TEBMINAL, * 

TBMIDNT=T50B, * 

TBMPBTY=10, * 

TBMM0DL=5, * 

TBMTYPE=1050, * 

TBMADDB=6413, * 

TBMSTAT=TBANSCEIVE, * 

LASTTBM=LINE 
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2260 DISPLAY STATIOM (BBMOTE/HOLTIPOIHT ONDBR CICS/DOS/VS1 

DFHTCT TYPE=SDSCI, * 

CU=2701, * 

DEVICE=2260, * 

LIHELST= (026 ) , * 

SWITCH=NO, * 

DSCNAME=DTF60R 

OPL2260 DFTRMLST OPEHLST, (40FF,4IFF) 

DFHTCT TYPE=LINE, * 

ACCMETH=BTAH, * 

TRMTYPE=2260, * 

TRMMODL=C, * 

DSCHAME=DTF60R, * 

BTAMRLN=1, * 

LISTADR=0PL2260, * 

INAREAL=960 

DFHTCT TYPE=TERMINAL, * 

TRHIDNT=R60A, * 

TRMADDR=40A0, * 

TRHPRTY=61, * 

TRUSTAT=TRASSCEIVE 

DFHTCT TYPE=TERHINAL, * 

TRtlIDNT=R60B, * 

TRMADDR =40A1, * 

TRMPRTY=62, * 

TRMSTAT=TRANSCE1VE 

DFHTCT TYPE=TER8INAL, * 

TRMIDNT=R530, * 

TRHTYPE=1053 r * 

TRHADDR=40A4, * 

TRMPRTY=32, * 

TRHSTAT=RECEIVE 

DFHTCT TYPE=TERMINAL, * 

TRMIDST=R65A, * 

TRMTYPE=2265, * 

TRMADDR=4151, * 

TRMPRTY=64, * 

TRHSTAT=TRA NSCEIYE, * 

LASTTERH=LINE 
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2740 COMMUNICATION TERMINAL (POINT-TO-POINT NON-SWITCHBD WITH VRC/LBC 
CHECKING UNDER CICS/DOS/VS) 


DFHTCT TYPE =SDSCI , * 

CU=2703, * 

DEVICE=2740, * 

FEATURE^ (CHK) , * 

LINELST= (029 ) , * 

SWITCH=NO, * 

DSCNAM£=DTF40B 

DFHTCT TYPE=LINE , * 

ACCMETH=BTAM, * 

TRMTYPE=2740, * 

FBATURE=CHECKING, * 

DSCNAM£=DTF40B, * 

INAREAL=120, * 

BTAMRLN=1 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=T40C, * 

TRMPRTY=202, * 

TRMSTAT-TRANSCEIVE, * 

LASTTRM=LINE 


2741 COMMUNICATION TERMINAL (POINT-TO-POINT NOK-SWITCHBD WITH 
CORRESPONDENCE CODE UNDER CICS/DOS/VS) 

DFHTCT TYPE =SDSCI f * 

CU=2703 # * 

DEVICE-2741C, * 

LINELST-(030), * 

SWITCH=NO, * 

DSCNAME=DTF41C 

DFHTCT TYPB^LINE 9 * 

ACCMBTH=BTAM , * 

TRMTYPE=2741C t * 

DSCNAME=DTF41C, * 

INAR£AL=120 r * 

BTAMRLN=1 

DFHTCT TYP£=TERMINAL, * 

TRMIDNT=T41A, * 

TRMPRTY=129, * 

TRMSTAT=TRANSCEIVE, * 

LASTTRM=LINE 
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7770 AHDIO RESPONSE UNIT (SWITCHED DNDBB CICS/OS/VS) 

DCB DFHTCT TYPE=SDSCI, * 

DEVICE=7770, * 

DSCNAHE=DCB7770, * 

APPENDG=Z3 

L17770 DFHTCT TYPE=LINE, * 

ACCMETH=BTAH, * 

TRJ9TYPE=7770, * 

DSCNAME=DCB7770, * 

INAREAL=256, * 

BTAHRLN =1, * 

FEATORB=AUTOANSR, * 

ANSWRBK=TERHINAL, * 

CONVTAB=ABB, * 

RDYHSG=READY, * 

BRRHSG=ERROR, * 

POOLADR=T17770 

L27770 DFHTCT TYPB=LINE, * 

ACCHETH=BTAM, * 

TRMTYPE=7770, * 

DSCHAME=DCB7770, * 

INAREAL=256, * 

BTAMRLN=2, * 

FEATORE=AUTOANSR, * 

ANSWRBK=TERHINAL, * 

CONVTAB=ABB, * 

RDYMSG=READY, * 

ERRHSG=ERROR 

L37770 DFHTCT TYPE=LINE, * 

ACCMETH=BTAM, * 

TRMTYPE=7770, * 

DSCNAMB=DCB7770, * 

INAREAL=256, * 

BTAMRLN=3, * 

FEATORE=ADTOANSR, * 

ANSHRBK =TERMINAL, * 

CONVTAB=ABB, * 

RDYMSG=READY, * 

ERRMSG=ERROR 

L47770 DFHTCT TYPE=LINE, * 

ACCMBTH=BTAM, * 

TRMTYPE=7770, * 

DSCNAME=DCB7770, * 

INAREAL=256, * 

BTAMRLN=4, * 

FBATORE=AOTOANSR, * 

ANSWRBK=TBRHINAL, * 

CONVTAB=ABB, * 

RDYMSG=RBADY, * 

ERRH SG=ERROR 

T17770 DFHTCT TYPE=TERHINAL, * 

TRMIDNT=7771 , * 

TRMPRTY=30, * 

TRMTYPE=7770, * 

TRMSTAT=TRANSCEIVE 

T27770 DFHTCT TYPE=TERMINAL, * 

TRHIDNT=7772, * 

TRMPRTY=30, * 

TRMTYPE=7770, * 

TRHSTAT=TRANSCEIVE 

T37770 DFHTCT TYPE=TERMINAL, * 

TRMIDNT=7773, * 

TRMPRTY=30, * 
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TRMTYPE=7770, * 

TRMSTAT=TRAHSCEIVE 

T47770 DFHTCT TYPE=TERMINAL, * 

TRMIDNT=7774, * 

TRHPRTY=30, * 

TRMTYPE=7770, * 

TRMSTAT=TRANSCEIVE, * 

LASTTRM=POOL 

READY DFHTCT TYPE=7770MSG, * 

MESSAGE='001D0B• 

ERROR DFHTCT TYPE=7770MSG, * 

HESSAGE='OOOAQF * 

7770 AUDIO BBSPQMSE UNIT (SWITCHED ORDER CICS/DOS/VS) 

DTF DFHTCT TYPE=SDSCI, * 

DEVICE=7770, * 

DSCN AME=DTF7770, * 

SWITCH=YES, * 

1INE1ST= (080,081,082,083) , * 

BLKSIZE=256 

L17770 DFHTCT TYPE=LINE, * 

ACCMETH=BTAM, * 

TRMTYPE-7770, * 

DSCNAME=DTF777Q , * 

INAREAL=256, * 

BTAMRL8=1 , * 

FEATURE=AUTOANSR, * 

ANSWRBK=TERMINAL, * 

CONVTAB=ABB, * 

RDYMSG=READY , * 

ERRMSG=ERROR, * 

POOLADR=T17770 

L27770 DFHTCT TYPE=LINE, * 

ACCMETH=BTAH, * 

TRMTYPE=7770, * 

DSCNAME=DTF7770, * 

INAREAL=256, * 

BTAHRLN=2, * 

FEATURE=AUTOANSR , * 

ANSWRBK=TERMINAL, * 

CONVTAB=ABB, * 

RDYHSG=READY, * 

ERRMSG=ERROR 

L37770 DFHTCT TYPE=LINE, * 

ACCMETH=BTAM, * 

THMTYPE=7770, * 

DSCNAME=DTF7770, * 

INAREAL=256, * 

BTAMRLN=3, * 

FEATURE=AUTOANSR , * 

AHSHRBK=TBRHINAL, * 

CONVTAB=ABB, * 

RDYH SG=READY, * 

ERRM SG=ERROR 

147770 DFHTCT TYPE=LIHE, * 

ACCHETH=BTAH, * 

TRMTYPE=7770 , * 

DSCHAHE=DTF7770, * 

IHAREAL=256, * 

BTAMRLN=4, * 

FEATURE=AUTOANSR, * 
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ARSWRBK=TERMINAL, 

* 



CONVTAB=ABB, 

* 



RDYMSG=READY, 

ERRMSG=ERROR 

* 

T17770 

DF HTCT 

TYPE=TERMIHAL, 

* 



TRMIDNT=7771, 

* 



TRMPRTY=30, 

* 



TRMTYPE=7770, 

TRMSTAT=TRANSCEIVE 

* 

T27770 

DFHTCT 

TYPE=TERMINAL, 

* 



TRMIDNT=7772, 

* 



TRMPRTY=30, 

♦ 



TRMTYPE=7770, 

TRMSTAT=TRANSCBIVE 

* 

T37770 

DFHTCT 

TYPE=TERMINAL, 

* 



TRMIDNT=7773, 

♦ 



TRMPRTY=30, 

* 



TRMTYPE=7770, 

TRMSTAT=TRAHSCEIVE 

* 

T47770 

DFHTCT 

TYPE=TERNINAL, 

♦ 



TRMIDNT=7774, 

* 



TRMPRTY =30 , 

* 



TRMTYPE=7770, 

♦ 



TRMSTAT=TRANSCEIVE, 

LASTTRM=POOL 

* 

READY 

DFHTCT 

TYPE=7770MSG, 

MESSAGE 3 '001D0B' 

* 

ERROR 

DFHTCT 

TYPE=7770MSG, 

MESSAGE= , 000A0P' 

* 


TELETYPEWRITER EXCHANGE TERMINAL (CPT-TWX) (SWITCHED* USING AUTO-IP AMP 
AUTOPOLL, UNDER CICS/DOS/VSl 


DFHTCT TYPE=SDSCI, * 

CU=2702, * 

DE VICE=TW35 , * 

LINELST= (039) , * 

SWITCH=YES , * 

DSCNAME=TWXOHE 

IDLTWX DFTRMLST IDLST,0,19,01B151FFC393C3CB052BBB1BB15IE1E1EIE 1A1 

TWXIDA DFTRMLST IDLST,7, 4931683, 10,500AB222C3052B2B9AB 1 

DFHTCT TYPE=LINE, * 

ACCMETH=BTAM, * 

TRMTYPE=TWX, * 

DSCNAME=TWXONE, * 

INAREAL=120, * 

BTAMRLN=1, * 

LISTADR =IDLTWX, * 

FEATURE= (AUTOAHSR, AUTOCALL), * 

POOLADR=TWXAUTO, * 

ANSWRBK=AUTO 

TWXAUTO DFHTCT TYPE=TERMINAL, * 

TRMIDNT=TWXA, * 

TRMADDR=TWXIDA, * 

TRMPRTY=201, * 

TRMSTAT=TRANSCBIVE, * 

LASTTRM=POOL 
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TELBTYPEWBITBB (WTC ONLY) (SWITCHED UNDER CICS/DOS/VS) 


DFHTCT TYPB=SDSCI, * 

DEVICE=TLX , * 

DSCNABE=WTTLX, * 

FEATOBE= (WRO) , * 

C0=2701, * 

LINELST= (051) , * 

BONDLY=10, * 

EOB=WRU, * 

EOT=X * 371F* 

FSLST DFTBBLST WTTALST,0,8,FFFFFFFFFFFFFFFF,7,F2F2F6F7F7F0F5 

DFHTCT TYPB=LINE, * 

ACCBETH=BTAB, * 

TBBTTPE=TLX , * 

INAREAL=300, * 

CLASS=HABDCOPY, * 

DSCNABE=WTTLX, * 

BTABRLN=1, * 

LISTADB=FSLST, * 

FEATORE=AUTOANSR, * 

POOLADB=TEBB1, * 

ANSWBBK=AUTOBATIC 

TBBB1 DFHTCT TYPE=TERBINAL, * 

TRBIDNT=DHFB, ♦ 

CLASS=HARDCOPY r * 

LASTTRB=POOL, * 

TRBADDR=IDLIST 

IDLIST DFHTCT TYPE=TLXID, * 

TLXID=*7266521 IBB D* 

DFHTCT TYPB=TLXID, * 

TLXID='8354305 IBB D', * 

LASTID=YES 
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2980 GENERAL BANKING TERMINAL SYSTEM (MOLTIPOINT PNDER CICS/OS/VS) 


DFHTCT TYPE=SDSCI, * 

DEVICE=BSCMDMPT, * 

BSCODE=EBCDIC, * 

DSCNAME=DTF2980 

TCT29POL DFTRMLST AOTOWLST, (C1C1F02D,37373737) POLL CO 

TCT29PA1 DFTRMLST OPENLST, (8181402D) ADDRESS STATION 1 

TCT29PA2 DFTRMLST OPENLST, (8181F12D) ADDRESS STATION 2 

TCT29PA3 DFTRMLST OPENLST, (8181F22D) ADDRESS STATION 3 

DFHTCT TYPB=LINE, * 

ACCMBTH=BTAH, * 

TRMTYPE=2980, * 

DSCNAME=DTF2980, * 

INAREAL=480, * 

BTAMRLN=1, * 

LISTADE= (TCT29POL,tiRAP) , * 

FEATORE=AOTOPOLL 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=T801, * 

STN2980=0, * 

TAB2980=04, * 

POLLP0S=01, * 

TRMADDR=TCT29PA1, > * 

TRMMODL=1, * 

TRMPRTY=10, * 

TIOAL=200, * 

TRMSTAT=TRANSCBIVB 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=T802, * 

STN2980=1, * 

TRMADDR=TCT29PA2, * 

TRHMODL=2, * 

TRMPRTY=10, * 

TIOAL=200, * 

TRMSTAT=TRANSCEIVE 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=T803, * 

STN2980=2, * 

TAB2980=02, * 

TRMADDR=TCT29PA3, * 

TRMMODL=4, * 

TRMPRTY=10, * 

TIOAL=200, * 

TRMSTAT=TRANSCEIVB, * 

LASTTRM=LINE 


Note : This is a functional example for CICS/DOS/VS if the 
(C1C1F02D,37373737) parameters in the above TCT29POL DFTRMLST statement 
are changed to 3732,C1C1F02D. 
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3270 INFORMATION DISPLAY SYSTEM (BTAMj (MULTIPOINT ONDER CICS/OS/VS) 


POLL77 DFTRMLST AUTOWLST, (40407F7F2D,C1C17F7F2D,3737373737) 


LSTR77A DFTRMLST OPENLST, (606040402D) 

LSTR77B DFTRMLST OPENLST, (616140402D) 

LSTR77C DFTRMLST OPENLST, (6161C1C12D) 

DFHTCT TYPE=SDSCI, * 

DEVICE=BSCMDMPT, * 

DSCNAME=REMOTE77, * 

BSCODE=EBCDIC 

DFHTCT TYPE=LINB, * 

ACCMETH=BTAM, * 

TRMTYPE=R3270, * 

LISTADR= (POLL77,WRAP) , * 

BTAMRLN=1, * 

DSCNAME=REMOTE77, * 

INAREAL=256, * 

TRMMODL=2, * 

FEATURE=AUTOPOLL 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=R77A, * 

TRMMODL=1, * 

TRMTYPE=3275, * 

TRMADDR =LSTR77A, * 

POLLPOS=1, * 

COMPAT=(480,12,2260,3) , * 

FEATURE=PTRADAPT, * 

| CLASS=BISYNC, * 

TIOAL=500 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=R773, * 

TRMADDR=LSTR77B, * 

PO LLP OS =2 , * 

COMPAT= (960,15,2265,D) , * 

FEATURE=(COPY,DCKYBD,SBLCTPEN) , * 

| CLASS=BISYNC, * 

TIOAL=1500 

DFHTCT TYPB=TBRMINAL, * 

TRMIDNT=R77C, * 

TRMTYPE=R327 OP * 

FEATURE=COPY, * 

| CLASS=BISYNC, * 

TRMADDR=LSTR77C, * 

LASTTRM=LINE, * 

TRMSTAT =TRANSCEIVE, * 

TIOAL=1500 


Note : This is a functional example for CICS/DOS/VS if: 

1. The (40407F7F2D, C1C17F7F2D,3737373737) parameters in the above 
POLL77 DFTRMLIST statement are changed to 

3732,40407F7F2D,C1C17F7F2D, and 

2. The LINELST=(029), MODELST=(0), and C0=27O3 operands are included 
in the DFHTCT TYPE=SDSCI specification. 

| 3. CONFIG=MPT is specified in DFHTCT TYPE=SDSCI. Otherwise, the 
| default of CONFIG=PPT will be taken, and a command reject will be 

| issued. 
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3740 DATA ENTRY SYSTEM (MULTIPOINT 08PER CICS/DOS/TS) 


DFHTCT TYPB=SDSCI, * 

DEVICE=3740, * 

DSCNAME=MPT3740, * 

CUT 703, * 

LINELST= (026) , * 

MODELST=(0>, * 

FBAT0RE= (BSC) , * 

CONFIG=MPT, * 

DFHTCT TYPE TINE, * 

ACCMETH=BTAM, * 

TRMTYPE=3740, * 

INAREAL=600, * 

DSCNAME=MPT3740, * 

BTAMRLN=1, * 

LISTADR=(POLL3740,WRAP) , * 

FEATURE=AUTOPOLL 

DFHTCT TYPETERMINAL, * 

TRMIDNTT374, * 

TBMTYPE=3740, * 

TIOAL=128, * 

TRMADDR=ADDR3741, * 

TRMSTATTRANSCEIVE, * 

FEATURE TRANSPARENCY, * 

BOFFER=128 

POLL3740 DFTRHLST AUT0HLST,3732,C1C12D ,C2C22D 
ADDR3740 DFTRHLST OPENLST,(81812D) 

ADDS3741 DFTRHLST OPENLST, (82822D) 

3780 DATA COHHUNICATION TERMINAL (MULTIPOINT UNDER CICS/OS/VS) 

DFHTCT TYPE=SDSCI, * 

BSCODE=EBCDIC, * 

DDNAME=DD3780, * 

DEVICE=3780, * 

DSCNAME=DCB3780 

DFHTCT TYPE=LINE, * 

TRMTYPE=3780, * 

DSCNAME=DCB3780, * 

ACCMETH=BTAM, * 

BTAMRLN=1, * 

BSCODE=EBCDIC, * 

INAREAL=520, * 

FEATURE=AUTOPOLL, * 

LISTADR= (LA3780,WRAP) 

DFHTCT TYPE TERM INAL, * 

TRMIDNT=B37A, * 

LASTTRM=LINE, * 

TIOAL=80, * 

TRMTYPE=3780, * 

BUFFBR=512, * 

TRMADDRTA3780 

LA3780 DFTRHLST A0TOWLST, (C1C1F02D,37373737) 

TA3780 DFTRMLST OPENLST, (81812D) 
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3600 PINAHCB COMMONICATION SYSTEM (BSC) (MOLTIPOINT UNDER CICS/OS/VS) 


DFHTCT TYPE=SDSCI, * 

DEVICE=3600 , * 

DSCNAME=DCB3600, * 

BSCODB=EBCDIC 

TCT36POL DFTRMLST AUTOHLST,(C2C2F02D,C8C8F12D,37373737) 

TCT36PA1 DFTRMLST OPENLST, (8282F72D) STATION ON C01 

TCT36PA2 DFTRMLST OPENLST,(8282F42D) STATION ON C01 

TCT36PA3 DFTRMLST OPENLST,(8888F32D) STATION ON C02 

DFHTCT TYPE=LINE, * 

ACCMETH=BTAM, * 

TRMTYPE=3600, * 

LISTADR=(TCT36POL,WRAP) , * 

DSCNAME=DSC3600, * 

FEATURE= (ADTOPOLL) , * 

INAREAL=400, * 

BTAMRLN=1, * 

CLASS= (BISYNC,CONV ) 

DFHTCT TYPB=TERMINAL, * 

TRMIDNT=A001, * 

TRMSTAT=(TRANSCEIVE), * 

TRMADDR=TCT36PA1, * 

POLLPOS=01, * 

FEATURE= (TRANSPARENCY) , * 

TIOAL=20, * 

BOFFER=100 

DFHTCT TYPE=TERMINAL, * 

TRHIDNT=A002, * 

TRMSTAT= (TRANSCEIVE), * 

TR M A D DR =T CT 3 6 P A 2 , * 

POLLP0S=02, * 

FEATURE=(TRANSPARENCY), * 

TIOAL=30, * 

BUFFER=100 

DFHTCT TYPE TERMINAL, * 

TRMIDNT=A003, * 

TRMSTAT=(TRANSCEIVE), * 

TRMADDR=TCT36PA3, * 

POLLP0S=03, * 

FBAT0RE= (TRANSPARENCY ) , * 

TIOAL=20, * 

BUFFER=100 


Note : This is a functional example of CICS/DOS/VS if: 

1. The (C2C2432D,C8C8662D,37373737) parameters in the above TCT36POL 
DFTRMLST statement are changed to 3732,C2C2F02D,C8C8F12D ana 

2. The LINELST=(040), RETRY=6, CU=2703, CONFIG=MPT, and FBATURB= (BSC) 
are added to the DFHTCT TYPE=SDSCI specification. 
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2 780 DATA TRANSMISSION TERMINAL (POINT-TO-POINT MOM-SWITCHED 
ONDBR CICS/DOS/VS) 


DFHTCT TYPE=SDSCI, * 

BSCODE=EBCDIC, * 

DEVICE=2730, * 

DSCNAME=DCBN2780, * 

CU=2703, * 

LINELST= (023) , * 

PEAT0RE=(BSC,SLV), * 

HODELST= (0) , * 

CONFIG=PPT, * 

SWITCH=NO 

DPHTCT TYPE=LINE, * 

TRMTYPE=2780, * 

DSCNAME=DCBN2780, * 

ACCMETH=BTAM, * 

BTAHRLN=1, * 

BSCODE=EBCDIC, * 

INAREAL=520 

N2780 DPHTCT TYPE=TERHINAL, * 

TRMIDNT=T80A, * 

LASTTRH=LINE, * 

TRBTYPE=2780, * 

TIOAL=100, * 

TRUSTAT=TRANSCEIVE, * 

TRHPRTY=126 

2770 DATA COMBONICATION SYSTEM (SWITCHED PNDBR CICS/OS/VS) 

DPHTCT TYPE=SDSCI, * 

BSCODE=EBCDIC, * 

DDHAME=DDD2770, * 

DE?ICE=2770, * 

DSCNAME=DCBD2770, * 

MACRF=(R,N), * 

MODB= (, ,A, A ) 

DPHTCT TYPE=LINE, * 

TRHTYPE=2770, * 

DSCNAHE=DCBD2770, * 

ACCHBTH=BTAB, * 

BTAHRLN=1, * 

BSCODE=EBCDIC, * 

POOLADR=D2770, * 

INARBAL=520, * 

PEATORE=AOTOANSR, * 

LISTADR=LA2770, * 

ANSWRBK=TERHINAL 

D2770 DPHTCT TYPE=TERMINAL, * 

TRMIDNT=D70A, * 

LASTTRM=POOL, * 

TIOAL=100, * 

TRHTYPE=2770, * 

TRHADDR=TA2770, * 

TRMSTAT=TRANSCEIVE, * 

TRMPRTY=126 

LA2770 DPTRMLST BSCLST,0,1,2D,2,1070 

TA2770 DPTRHLST BSCLST,0,2,1070,1,2D 
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SYSTEM/3 (SWITCHED DMDBS CICS/OS/VS) 


DFHTCT TYPE=SDSCI, * 

BSCODE=EBCDIC, * 

DDNAHE=DDDSYS3, * 

DEVICB=SYS/3, * 

DSCNAME=DCBDSYS3 , * 

MACRF= (R,W) 

DFHTCT TYPB=LINE, * 

TRMTYPE=SYS/3, * 

DSCNAME=DCB DSYS3, * 

ACCMETH=BTAM, * 

BTAMRLN=1, * 

BSCODE=EBCDIC, ♦ 

POOLADR=SYS3D, * 

INAREAL=500 , 96 X 5 + 20 PAD * 

FEATURE=ADTOANSR, * 

LISTADR=LASYS3, * 

AN SWRBK=TERMINAL 

SYS3D DFHTCT TYPE=TERMINAL, * 

TRMIDNT=DSY3, * 

LASTTRM=POOL, * 

TIOAL=100, * 

TRMTYPE=SYS/3, * 

TRMADDR=TASYS3, * 

TRMSTAT=TRANSCEIYE , * 

TRMPRTY=126 

LASYS3 DFTRMLST BSCLST,0,1,2D,2,1070 

TASYS3 DFTRMLST BSCLST,0,2,1070,1,2D 

3275 DISPLAY STATION (DIAL/SWITCHED UNDER CICS/DOS/VS1 

DFHTCT TYPE=SDSCI, * 

DEVICE=3275, * 

DSCNAME=DD3275D, * 

LINELST= (044) , * 

CU=2703, * 

FBATORE=(BSC), * 

MODBLST=(0), * 

SHITCH=YES 

DFHTCT TYPE=LINE, * 

ACCMETH=BTAM, * 

TRMTYPE=3275, * 

INABEAL=300, * 

TCTUAL=16, * 

| CLASS=BISYNC, * 

DSCN AME=DD3275D, * 

TRMMODL=2, * 

BTAMRLN=1, * 

LISTADR=ANS3275D, * 

FEATORE=(AUTOANSR,AUTOCALL) , * 

ANSHRBK=EXIDVER 

R75D DFHTCT TYPE=TERMINAL, * 

TRMIDNT=R75D, * 

LASTTRM=POOL, * 

TRMSTAT=TRANSCEI¥E, * 

COMPAT=(960,12,2260,1,F2260), * 

FEATURE=(PTRADAPT,SELCTPEN,DCKYBD) , * 

TIOAL=1500, * 

TCTUAL=16, * 

PGESTAT=A0TOPAGE 

ANS3275D DFTRMLST SBLST,AN,10,4,2,1070,(86A54C5A2D,0,R75D> 


714 


CICS/VS System Programmer's Reference Manual 



3735 PROGRAMMABLE BUFFBRED TBRHINAL (SWITCHED OHPER CICS/OS/VSI 

DFHTCT TYPE=SDSCI, * 

DEVICE=BSCHDSW, * 

BSCODE=EBCDIC, * 

DSCNAHE=DTF35D 

DFHTCT TYPE=LINE, * 

ACCHETH=BTAH, * 

TRHTYPE=3735, * 

DSCNAHE=DTF35D, * 

INAREAL=480, * 

BTAHRLN=1, * 

LISTADR=LISTA, * 

FEATURE=(AUTOANSR,AUTOCALL), * 

POOLADR=A3735, * 

BSCODE=EBCDIC, * 

ANSWRBK=EXIDVER 

A3735 DFHTCT TYPE=TERHINAL, * 

TRHIDNT=3735, * 

TRHTYPE=3735, * 

LASTTRH=POOL, * 

TRHADDR=LISTB, * 

TRHSTAT=TRANSCEIVE, * 

TRANSID=3735, * 

TIOAL=476 

LISTA DFTRHLST SWLST,AN,11,4,2,1070, (98F0F3F5182D,,A3735) 

LISTB DFTRHLST SWLST,AD,4,3374,8,0,1,2D,(98F0F3F5181070,1) 

3740 DATA EHTRY SYSTEM (DIAL/SWITCHBD UNDER CICS/DOS/TS) 

DFHTCT TYPE=SDSCI, * 

DEVICE=3740, * 

DSCNAHE=DD3741A, * 

3SC0DE=EBCDIC, * 

FEATURE=(BSC), * 

SWITCH=YES, * 

CU=2703, * 

CONFIG=PPT, * 

LINELST= (016), * 

MODELST= (0) 

DFHTCT TYPE=LINE, * 

ACCHBTH=BTAH, * 

TRMTYPE=3740, * 

DSCNAHE=DD3741A, * 

ANSWRBK=EXIDVER, * 

INAREAL=514, * 

BTAMRLN=1, * 

LISTADR=LISTANA, * 

FEATURE=(AUTOANSR,AUTOCALL), * 

POOLADR=TRHA3741, * 

BSCODE=EBCDIC 

TRHA3741 DFHTCT TYPE=TERHINAL, ♦ 

TRHIDNT=A374, * 

TRMTYPE=3740, * 

LASTTRM=POOL, * 

TRHADDR=LISTADA, * 

TRHSTAT=TR ANSCEIVE, * 

TIOAL=128, * 

FEATURE=TRAHSPARENCY 

LISTANA DFTRHLST SHLST,AN,10,4,2,1070,(A58189A52D,,TRHA3741) 

LISTADA DFTRHLST SWLST,AD,4,3729,8,0,1,2D, (A58189A51070) 
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3740 DATA ENTRY SYSTEM UNDER CICS/OS/YS (POINT-TO-POINT SWITCHED> 


DPHTCT TYPB=SDSCI, * 

DEVICE=BSCMDPPT, * 

DSCNAME=DD3740 

DPHTCT TYPE=LINE, * 

ACCMETH=BTAM, * 

TRMTYPE=3740, * 

DSCNAMB=DD3740, * 

INAREAL=608, * 

BTAMRLN=1, * 

LISTADR=ANSW3740, * 

FEATORE=<AUTOANSR,AUTOCALL), * 

POOLADR=T3740, * 

ANSWRBK=EXIDVER 

T3740 DPHTCT TYPE=TERMINAL, * 

TRHIDNT=3740, * 

TRMTYPB=3740, * 

LASTTRH=LINE, * 

TRMSTAT=TRANSCEIVE, * 

FEATURE=TRANSPARENCY, * 

TIOAL=128, * 

B0FPER=128 

ANSW3740 DPTRMLST SWLST,AN,10,4,2,1070,(A58189A52D,,T3740) 

DIAL3740 DPTRMLST SWLST,AD,4,3375,8,0,1,2D, (A58189A51070,1) 

2540 CARD READER—PONCH/1403 PRINTER UNDER CICS/DOS/YS 

DPHTCT TYPE=SDSCI, * 

DEVADDR=SYSIPT, * 

DEVICE=2540, * 

DSCNAME=RBADER 

Dfhtct TYPE=SDSCI, * 

DEVADDR=SYSLST, * 

DEVICE=1403, * 

DSCNAME=PRINTER 

DPHTCT TYPE=LINE, * 

ACCMETH=BSAM, * 

TRMTYPECRLP, * 

ISADSCN=READER, * 

OSADSCN=PRINTER, * 

INAREAL=80 

DPHTCT TYPE=TERMINAL, * 

TRMIDNT=SAMA, * 

TRMTYPE=CRLP, * 

TRSSTAT=TRANSCEIVE 
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2314 DIRECT ACCESS STORAGE FACILITY UNDER CICS/DOS/VS 


DFHTCT TYPB=SDSCI, * 

DEVADDR=SYS001 , * 

DEVICE=2314, * 

DSCNAME=DISKIN1 

DPHTCT TYPE=SDSCI, * 

DEVADDR=SYS006, * 

DEVICE=2314, * 

DSCNAHE=DISKOT1 

DFHTCT TYPE=LINE, * 

ACCMETH=SEQUENTIAL, * 

TRMTYPE=DASD, * 

ISADSCN=DISKIN1, * 

OSADSCN=DISKOT1, * 

INAREAL=80 

DFHTCT TYPE=TERMINAL, * 

TRBIDNT=SAKB, * 

TRBPRTY=11, * 

TRBSTAT=(TRANSCEIVB,*OOT OF SERVICE*) 

PROCESSOR CONSOLE AS A TERHINAL - CICS/DOS/VS ONLY 

DFHTCT TYPE=SDSCI, * 

DEVICE=CONSOLE 

DFHTCT TYPE=LINE, * 

ACCBETH=SEQUENTIAL, * 

INAREAL=80, * 

TRBTYPE=CONSOLE 

DFHTCT TYPE=TERMINAL, * 

TRBIDNT=CNSL, * 

TRHSTAT=TRANSCEIVE 
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3270 INFORMATION DISPLAY SYSTEM (BTAM, LOCAL) UNDER CICS/OS/YS 


DFHTCT TYPB=SDSCI, 

DEVICB=L3277, 

DSCNAME=L3270 

DFHTCT TYPE=LINE, * 

ACCMETH=BTAM, * 

DSCNAME=L3270, * 

TRMM0DL=2, * 

| TRMTYPE=L3270, * 

POOL ADR=T010, * 

INAREAL=2500, * 

POOLCNT=2 

T010 DFHTCT TYPE=TERMINAL, * 

TRMIDNT=L77A, * 

LVONIT=1, * 

FEATURE= (SELCTPEN ,AUDALARM) , * 

COHPAT=(480,12,2260,3) 

DFHTCT TYPE=TERMINAL, * 

TR8IDNT=L77B, * 

LVONIT=2, * 

I TRMTYPE=L3270, * 

LASTTRM=POOL, * 

TRMSTAT=TRANSCEIVE 


Note: This is a functional example for CICS/DOS/VS if: 

1. The CO=3272 and LINELST=(030,031) operands are included in the 
DFHTCT TYPE=SDSCI specification, 

2. The POOLCNT=2 operand is deleted from the DFHTCT TYPE=LINE 
specification. 
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2260 DISPLAY SIA-IIOH (LOCAL > UNDER CICS/OS/VS AMD CICS/DOS/VS 


DFHTCT TYPB=SDSCI, * 

CU=2848, (CICS/DOS/VS only) * 

DEVICE=L2260, * 

LINELST=(021,022,023) , * 

FEATURE=KBL, * 

SWITCH=NO, * 

FLHHAME=LINE1, (CICS/OS/VS only) * 

DSCNAHE=DFF60L 
LINE1 DFHTCT TYPE=LINE, 

ACCMETH=BTAM, ACCMETH=BGAM for CICS/OS/VS * 

TRMTYPE=L2260, * 

CLASS=VIDEO, * 

DSCHAME=DTF60L, * 

INAREAL=900, * 

FEATURE=KBRDL0CK 

DFHTCT TYPE=TER8INAL, * 

TRMIDNT=L60A, * 

LVUNIT=1, * 

TRMPRTY=32, * 

TRMSTAT=TRANSCEIVE 

DFHTCT TYPS=TERHINAL, * 

TRMIDNT=L60B, * 

LVUNIT=2, * 

TRMPRTY=32, * 

TRMSTAT=TRAHSCEIVE 

DFHTCT TYPE=TERHINAL, * 

TRMIDHT=L530, * 

TRMTYPE=1053, * 

LVUNIT=3, * 

TRHPRTY=32, * 

TRMSTAT=RECEIVB, * 

LASTTRH=LINE 
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TCAM TERMINAL COHTROL TABLE (ClCS/OS/VS ONLY 1 


DFHTCT TYPE=IHITIAL, * 

SUFFIX=TV 

DFHTCT TYPE=SDSCI, * 

DEVICE=TCAM, * 

DSCNAME^LI, * 

DDNA8E=QIN1, * 

OPTCD=WU # * 

MACRF=R , * 

RECFM=U, * 

BLKSIZE=500 

DFHTCT TYPE=SDSCI , * 

DEVICE=TCAM, * 

DSCNAME=L2 , * 

DDNAME=QOUT1, * 

OPTCD=WU, * 

MACRF=W 9 * 

RECFM=U, * 

BLKSIZE=500 

DFHTCT TYPE=LINE, * 

ACCMETH=TCAM # * 

QUEUEID=F1, * 

INAREAL=500 , * 

TRHTYPE=L2260, * 

DSCNAME=L1, * 

OOTQ=OUTQ 

DFHTCT TYPE=TERMINAL, * 

TR MID NT=DM MY # * 

TRMPRTY=32 , * 

LASTTRM=LINE 

OUTQ DFHTCT TYPE=LINE , * 

ACCMETH=TCAM, * 

QUEQEID=FO, * 

INAREAL=500 # * 

TRMTYPB=L2260, * 

DSCHAME=L2 

DFHTCT TYPE=TERMINAL, * 

TRHIDNT=TRM, * 

TRMPRTY=32 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=TRH2 r * 

LASTTRM=LINE, * 

TRMPRTY=32 

DFHTCT TYPE=SDSCI , * 

DEVICE=TCAM, * 

DSCNAME=R70IN, * 

DDNAME=R3270IN, * 

OPTCB=WO, * 

HACRF=R, * 

RECFM=U, * 

BLKSIZE=500 

DFHTCT TYPB=SDSCI, * 

DEVICE=TCAM, * 

DSCNAHE=R7000T, * 

DDHAME=R3270OtJT, * 

OPTCD=WU, * 

MACRF=W, * 

RECFH=U, * 

BLKSIZE=500 

DFHTCT TYPE=LINE, * 

ACCHETH^TCAM, * 

INAREAL=500, * 

DSCNAME=R70IN, * 
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OOTQ=OOTQ70, * 

Tfi.HT.IEE~3277 

DFHTCT TYPE=TEBHINAL, * 

TBMIDNT=DHHX, * 

TBMPRTY=32, * 

LASTTBN=LINE 

O0TQ70 DFHTCT TYPE=LINB, * 

ACCHETH=TCAH, * 

INABEAL=500, * 

DSCNAME=R7000T, * 

TBHTYPE=3277 

DPBTCT TYPE=TEBHINAL, * 

TBHPBTY=32, * 

TBHIDNT=S70A 

DFHTCT TYPE=TEBHINAL, * 

TRHPBTY=32 , * 

TBHIDNT=S70B 

DPBTCT TYPE=TEBMINAL, * 

TBMPRTY=32, * 

TRHIDNT=S75A, * 

LASTTBH=LINE 

DPHTCT TYPE=PINAL 

END 
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3600 FINAMCE COBBPHICATION SYSTEM 


DFHTCT TYPE TERMINAL, * 

TRMIDNT=H S12 , * 

TRHPRTY=50, * 

TRHTYPE=3600, * 

TRHSTAT=TRANSACTION, * 

TIOAL=256, * 

TCTUAL=100, * 

PGESTAT=PAGE, * 

PGESIZE= (6,40) , * 

3UFFBR=224, * 

LDC=BMSLLDC1, * 

ACCMETH=VTAH, * 

NETNA HE =WS12, * 

CONNECT=AOTO, * 

RELREQ= (YES,YBS), * 

BRACKBT=YES 


Associated local 1DC list: 

BHSLLDC1 DFHTCT TYPE=LDCLIST, * 

LDC= (DS,JP,PB=5,LP,MS) 


System LDC table entry: 

DFHTCT TYPE=LDC, * 

LDC=(DS=1), * 

DVC=3604, * 

PGESIZE= (6,40), * 

PGESTAT=PAGE 


Standard system LDC table: 

DFHTCT TYPE=LDC, * 

LDC=SYSTE(! 

Note: See the appropriate CICS/VS subsystem guides for additional 

information regarding LDCs. 

3614 CONSOHER TRANSACTION FACILITY 

DFHTCT TYPS=TERHINAL, * 

TRHIDNT=L14A, * 

TRHTYPE=3614, * 

ACCHETH=VTAH, * 

TRAMSID=36CB, * 

TRHSTAT=('OUT OF SERVICE*,TRANSCEIVE), * 

TRMPRTY=50, * 

TIOAL=256, * 

OPERSEC=14, * 

BRACKET=NO, * 

NETNAME=FC3614LP, * 

RELREQ= (NO,NO) , * 
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CONNECT=AUTO 


3600 PIPELINE LOGICAL UNIT 

DFHTCT TYPE=TERMINAL, * 

TRHIDNT=BPT8, * 

TRMTY PE=3600, * 

BMSFEAT=NOROUTE, * 

TRMSTAT= (*OUT OF SERVICE•,TRANSACTION), * 

TIOAL=256, * 

SESTYPE=PIPELN , * 

TRANSID=3606 , * 

OPERID=JTWW, * 

OPERPRI=5, * 

OPERSEC= (5^6,7) , * 

PIPELN=LAST, * 

BRACKET=NO, * 

TASKNO=1, * 

ACCMETH=VTAM, * 

NETNAME=WS12, * 

RELREQ= (YES,NO) , * 

BUFFER=32 

3650 HOST CONVERSATIONAL (3653 ) LOGICAL UNIT 

DFHTCT TYPE=TBRMINAL, * 

TRMIDNT=HCR1, * 

TRMTYPE=3650, * 

BMSFEAT=NOROUTE, * 

TRMSTAT= (■OUT OF SERVICE•/TRANSACTION) , * 

TIOAL=256, * 

SESTYPE=3653/ * 

OPERID=JTWW, * 

OPERPRI=5/ * 

OPERSEC= (5/6/7) / * 

ACCMETH=VTAM/ * 

NETNAME=HCD1/ * 

CONNECT=A(JTO , * 

RELREQ= (YES/HO) # * 

BRACKET=YES, * 

B0FFER=240 

3650 PIPELINE LOGICAL UNIT 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=PIP3, * 

TRMTYPE =3650/ * 

BMSFEAT=NOROUTE, * 

TRNSTAT= ( f OUT OF SERVICE•/TRANSACTION), * 

TIOAL=40/ * 

SESTYPE=PIPELN/ * 

TRANSID=3653 f * 

OPERID=JTW3/ * 

OPERPRI=5, * 

OPERSEC=(5/6/7) r * 

PIPELN=LAST, * 

TASKNO=4/ * 

ACCMETH=VTAM/ * 

NETNAHB=PIPW, * 

CONNECT=AUTO, * 
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RBi.REQ= (YES,YES) , * 

B0FFBR=32, * 

BRACKET=NO 

3650 HOST CONVERSATIONAL (3270) LOGICAL PNIT 

DFHTCT TYPE=TBRMINAL, * 

TRMIDNT=HCD2, * 

TRMTYPE=3650, * 

BMSFEAT=OBFMT, * 

TRMSTAT=(*OUT OP SERVICE* TRANSACTION) , * 

TIOAL=256, * 

SESTYPE=3270, * 

OPERID=JTWW, * 

OPBRPRI=5, * 

OPERSEC= (5,6,7) , * 

ACCMETH=VTAM, * 

NBTHA»E=HCD2, * 

COHHECT=AOTO, * 

RBLREQ= (YES , YES ) , * 

BRACKET=YES, * 

BUFFER=240 

3650 INTERPRETER LOGICAL PNIT 

DFHTCT TYPE=TERMINAL, * 

TRMIDRT=PROG, * 

TRMTYPE=3650, * 

BMSFEAT=(N0R00TEALL,FMHPARM) , * 

TRMSTAT=('OUT OF SERVICE«,TRANSCEIVE), * 

TIOAL=2 56, * 

SESTYPE=OSBRPROG, * 

OPERID=PRG1, * 

OPERPRI=5, * 

OPBRSEC= (5,6,7) , * 

ACCHETH=VTAM, * 

NETNAME=PROG, * 

CONNECT=AtJTO, * 

RELREQ= (YES,YES) , * 

BRACKET=YES, * 

BDFFER=240 

3650 HOST COMMAND PROCESSOR LOGICAL PNIT 

DFHTCT TRMTYPE=TERMINAL, * 

TRMIDNT=HCPA, * 

TRMTYPE=3650, * 

TRMSTAT=TRANSCEIVE, * 

TIOAL=256, * 

SESTYPE=OSERPROG, * 

ACC8ETH=VTAM, * 

NETNAME=QEHCPROC, * 

CONNECT=A0TO, * 

RELREQ=NO, * 

BUFFER=256, * 

BRACKET=NO 
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3270 INFORMATION DISPLAY SYSTEM (VTAMl 


DPHTCT TYPE=TERMINAL, * 

TRMIDNT=xxxx, * 

TRMTYPE=3277, * 

TRMMODL=1, * 

ACCMETH=VTAM, * 

TIOAL=1500, * 

TRMSTAT=(*OUT OF SERVICE'/TRANSACTION) , * 

NETNAME=yyyy, * 

CONNECT=AUTO, * 

RELREQ= (YES, YES) , * 

FEATURE=(COPY,DCKYBD,SELCTPEN), * 

PRINTTO= (LABI,COPY), * 

ALTPRT=LAB2 

3270 LARGE SCREEN SPPPORT 

| 1. BTAM/BSC 3276/3278 Model 3 Display: 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=aaaa, * 

| TRMTYPE=R3270 * 

TRMMODL=2, * 

ACCMETH=BTAM, * 

ALTSCRN=(32,80) 

2. BTAM/Local 3278 Model 1 Display: 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=bbbb, * 

| TRMTYPE=L3270, * 

TRMMODL=1, * 

ACCMETH=BTAM, * 

ALTSCRN= (12,80) 

3. VTAM/SDLC 3278 Model 4 Display: 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT =CCCC, * 

TRMTYPE=LUTYPE2, * 

TRMMODL=2, * 

ACCMETH=VTAM, * 

ALTSCRN=(43,80) 

4. VTAM/SDLC 3287 Printer: 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=dddd, * 

TRMTYPE=LUTYPB3, * 

TRMMODL=2, * 

ACCMETH=VTAM, * 

ALTSCRN= (32,80) REQUIRES EXTENDED BUFFER CAPACITY. 

ALTPGE NEED NOT BE SPECIFIED; HILL 
DEFAULT TO VALUE IN ALTSCRN 
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5. VTAM/SDLC 3289 SCS Printer: 


DFRTCT TYPB=TEHMINAL, * 

TRMDNT=eeee, * 

TRMTYPE=SCSPRT , * 

HF=YES, * 

VF=YES 


Note: For all TCTTEs that have either ALTSCRN or ALTPGE to select the 

alternative screen/page size values, the SCRNSZE=ALTERNATE operand must 
be specified in either DFHPCT TYPE=INITIAL or DFHPCT TYPE=ENTRY. 

The following table provides information on how to specify, through 
the TRMTYPE and SESTYPE operands of DFHTCT TYPE=TERMINAL, some of the 
| possible configurations for VTAM connected 3270 devices, some of which 
may be used to provide alternative screen size support. TRMTYPE and 
SESTYPE specifications are given for local, BSC, and SDLC connections. 
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Devices 

i 

Connection 

i 

TRMTYPE= 

| SB.SXY.PE~ 


3274+3278 

i 


i 


i 



i 

BSC 

i 

3270 

i — 



i 

i 

Local/SDLC 

(SNA) | 

LUTYPE2 

i 


3276 

1 

i 


1 

1 


! 

i 



i 

BSC 

1 

3270 

i — 



i 

i 

SDLC (SNA) 

1 

I 

LUTYPE2 

i — 

i 


3276+3278 

1 

i 


1 

1 


1 

i 



i 

BSC 

1 

3270 

i — 



i 

1 

SDLC (SNA) 

1 

LUTYPE2 

| 


3274+3277 

i 

i 


1 

I 


i 

i 


(no large 

i 

BSC 

1 

3270 

i —- 


screen support) 

i 

i 

Local/SDLC 

(SNA) | 

a 

LUTYPE2 

i - 

i 


3274+3284 or 

1 

i 


1 

1 


1 

i 


3286 (3288) 

i 

BSC 

1 

L32 70 

i — 


(no large 

i 

Local/SDLC 

(SNA) | 

LUTYPB3 

i — 


screen support) 

i 

> 


1 

| 


i 

i 


3274+3287 or 

l 

i 


1 

1 


1 

i 


3289 

i 

BSC 

1 

L3270 

i — 



i 

i 

Local/SDLC 

(SNA) | 

1 

LUTYPE3 

i - 

1 


3274+3284/3286 

I 

i 

i 

Local/SDLC 

(SNA) | 

1 

LUTYPE3 

i 


3274+3287/3289 

1 

i 

i 

Local/SDLC 

(SNA) | 

1 

SCSPRT 

1 

i - 

i 


3276+3287/3289 

i 

i 

a 

SDLC (SNA) 

1 

1 

I 

SCSPRT 

1 

i - 

• 


3276+3287/3289 

1 

1 


1 

1 


! 

i 



1 

BSC 

I 

L3270 

i — 



1 

1 

SDLC (SNA) 

1 

1 

L0TYPE3 

i — 

■ 


3790+3276, 

1 

1 


1 

1 


! 

i 


3277, or 3278 

1 


1 


i 


(no large 

1 

Local/SDLC 

(SNA) | 

3790 

| 3277CM 


screen support) 

1 

I 


1 

| 

LUTYPE2 

1 - 

■ 


3790+3287/3289 

1 

1 


1 

1 


1 

1 


(no large 

1 


1 


1 


screen support) 

1 

Local/SDLC 

(SNA)| 

3790 

| 3284CM/ 



1 


1 


| 3286CM 



1 

I 


1 

LUTYPE3 

1 - 


3790+3276 

1 

1 


1 

1 


1 

1 


+3287/3289 

1 


1 


1 



1 

Local/SDLC 

(SNA) | 

3790 

| 3286CM 



1 

a 


1 

1 

L0TYPE3 

1 


3790 + SCS 

1 

1 


1 

1 


1 

1 


printer (for 

1 


1 


1 


example, 3287) 

! 

Local/SDLC 

(SNA ) | 

3790 

| SCSPRT 



1 


1 

SCSPRT 

1 - 



L. 


Appendix B. Examples or Terminal Control Table Preparation 


727 








3767 COMMUNICATION TERMINAL 

DFHTCT TYPB=TERHINAL , * 

TRMIDNT-yyyy, * 

TRMPRTY=60, * 

TRMTYPE=3767, * 

TRHSTAT=TRANSCEIVE, * 

TIOAL-256, * 

PGESTAT=PAGE, * 

PGESIZE= (12,80) , * 

BOFFER=256, * 

BRACKET=YES, * 

ACCMETH=VTAM, * 

NETNAHE=XXXXXXXX, * 

CONNECT=AUTO, * 

RELREQ= (IBS ,YES ) , * 

?F=YES, * 

HF=TES 

3770 DATA COMMUNICATION SYSTEM (NON—PROGRAMMABLE) 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=zzzz, * 

TRMPRTY=50, * 

TRHTYPE=3770, * 

TRMSTAT=TRANSCEIYE, * 

CHNASSY=YES, * 

TIOAL=(256,1024), * 

R0SIZE=256, * 

PGESTAT=A0TOPAGE, * 

PGESIZE= (12,80), * 

BOFFER=256, * 

BRACKET=YES, * 

ACCMETH=YTAM, * 

NETNAME=xxxxxx, * 

CONNECT=A0TO, * 

RELREQ= (YES,YES) , * 

VF=YES, * 

HF=IES 

DFHTCT TYPE=LDC, * 

LDC=BCH10 
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3770 BATCH DATA INTERCHANGE LOGICAL OMIT 


DFHTCT TYPB=TEBHINAL, * 

TRHIDNT=LUT1, * 

TRMPRTY=50, * 

TRHTYPB=3770, * 

SESTYPE=BATCHDI, * 

TRMSTAT=THANSCEIVE, * 

TIOAL=(256,2048), * 

PGESTAT=AUTOPAGE, * 

ROSIZE=256, * 

BOPFER=256, * 

ACCHETH=VTAM, * 

HETNAHE=xxxyyy, * 

RELREQ=YES, * 

CHNASSY=YES, * 

TRAHSID=BDSA, * 

HF=YES, * 

VP=YBS, * 

1DC=1DCA, * 

BRACKET=YES 
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3770 FULL FUNCTION LOGICAL UNIT 


DFHTCT TYPE=TERMINAL, 
TRMIDNT=PCLU, 

TRETYPE=3770, 

SESTYPE=USERPROG, 

TRMSTAT=TRANSCEIVE, 

TIOAL=256, 

BRACKET=YES, 

ACCHETH=VTAM, 

NETNAME=LU04, 

BUFFER=256 


* 

* 

♦ 

* 

♦ 

* 

♦ 

* 

♦ 


3790 3270-DISPLAY LOGICAL UNIT 


DFHTCT TYPE=TERMINAL, * 

TRMIDNT=CCC2, * 

TRMTYPE=3790, * 

TREMODL=2, * 

TRESTAT=TRANSCEIVE , * 

FEATURE= (SELECTPEN,AUDALARE,UCTRAN,PTRADAPT), * 

| TIOAL= (256,1536) , * 

ACCMETH=VTAM, * 

SESTYPE=3277CM, (Screen compatibility) * 

METNAME=LU92, * 

| BUFFER=1536 


3790 FULL FUNCTION LOGICAL UNIT 


DFHTCT TYPE TERMINAL , * 

TRMIDNT=LU95, * 

TRETYPE=3790, * 

SESTYPE=USBRPROG , * 

TRMSTAT=TRANSCEIVE, * 

TIOAL=256 , * 

BRACKET=YES, * 

ACCMETH=VTAM, * 

NETNAME=LU95, * 

BUFFER=256 


3790 3270-PRINTER LOGICAL UNIT 


DFHTCT TYPB=TERMINAL 
TREIDNT=CCC5 , 
TRMTYPE=3790, 
TRMMODL=2, 
TRMSTAT=TRANSCEIVB, 
TIOAL = (256,1500) , 
ACCMETH=VTAM, 

SE ST YPE =328 6CM, 

NETNAME=LU98, 

BUFFER=256 


♦ 

♦ 

* 

♦ 

* 

* 

* 

(Print Compatibility LU) * 

* 
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3790 SCS—PRIKTBR LOGICAL P»IT 


DFHTCT TYPE=TERMIll AL, * 

TRMIDNT=CCC6, * 

TRMTYPE=3790, * 

TRHSTAT=TRANSCBIVE, * 

ACCMETH=VTAH, * 

SESTYPE=SCSPRT, (Print Compatibility LO) * 

NETHAME=L099 

3790 BATCH DATA INTERCHANGE LOGICAL PHIT 

DFHTCT TYPB=TERMINAL, * 

TRMIDNT=BLP1, * 

TRMPRTY=50, * 

TRHTYPE=3790, * 

SB STY PB=BATCHDI, * 

TRMSTAT=TRANSCEIVE, * 

TIOAL= (256,2048), * 

PGESTAT=APTOPAGE, * 

RPSIZE=256, * 

B0FFER=256, * 

ACCHETH =VTAH, * 

8ETNAMB=SLP3790, * 

RELREQ=YES, * 

CHNASSY=YES, * 

TRANSID=BD5A, * 

HF=NO, * 

VF=HO, * 

BMSFBAT=OBOPID, * 

LDC=LDCA, * 

BRACKET=YES 

3790 INQUIRY LOGICAL PHIT 

DFHTCT TYPE=TEBMINAL, * 

TRHIDNT=I1K3, * 

TRMTYPE=3790, * 

TRMSTAT=TRANSACTION, * 

ACCMETH=VTAM, * 

BOFFER=256, * 

BRACKET=YES, * 

RELREQ= (YES,NO) 

IDCs FOR 3770 BATCH LOGICAL OMIT 

DFHTCT TYPE=LDC, * 

LDC=XX, * 

DVC=BLOPRT, * 

PGESIZE= (12,80), * 

PGESTAT=PAGE 

DFHTCT TYPE=LDC, * 

LDC=YY, * 

DVC=BLUPCH, * 

PGESIZE= (1,80), * 

PGESTAT=APTOPAGE 

DFHTCT TYPE=LDC, * 

LDC=SYSTEM 
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EXTENDED LOCAL LDC LIST FOR 3770 AND 3790 BATCH DAT* INTERCHANGE 
LOGICAL UNITS 


LDC A DFHTCT TYPE=LDC, * 

LOCAL-INITIAL 

DPHTCT TYPE=LDC, * 

LDC=BCHL0 

DFHTCT TYPE=LDC, * 

LDC=AA, * 

DSN=P000004, * 

PGESTAT=ADTOPAGE, * 

DVC=BLUPRT, * 

PGESIZE=(30,132) 

DFHTCT TYPE=LDC, * 

LDC=BB, * 

DSN=P000005, * 

PGESTAT=AUTOPAGB, * 

DVC=BLUPRT , * 

PGESIZB= (30,132) 

DFHTCT TYPE=LDC, * 

LDC=CC, * 

DSN=P000008, * 

PGBSTAT=AUTOPAGE, * 

DVC=BLUPRT, * 

PGESIZE= (1,132) 

DFHTCT TYPE=LDC, * 

LDC-DD, * 

DVC=BLUPRT, * 

PGBSIZE= (30,123) 

DFHTCT TYPE=LDC, * 

LDC=EE, * 

DSN=P00000AA, * 

PGESTAT=AOTOPAGE, * 

DVC=BLUCON, * 

PGBSIZE= (30,132) 

DFHTCT TYPE=LDC, * 

LOCAL=FINAL 


CICS/YS INTEBCOMMPNICATION 

The first CICS/VS system is defined as follows: 


DFHTCT TYPB=INITIAL, 
APPLID=CICSNY, 

AC CM ETH= (YTAH) , 
SOFFIX=AB 

| CICSLA DFHTCT TYPB=SYSTBH, 

NETN A ME-CICSLA, 
SYSIDNT=RBH1, 
ACCMETH=VTAM, 
TRMPRTY=100, 
OPBRID=OP1, 
OPERSEC=15, 
0PERPRI=50, 
TRMIDNT=LAG1, 

| TRMSTAT=TRANSCEIVE, 

SBSTYPE=SEND, 
RUSIZE=512, 
BOFFES=512, 
LASTTRH=VTAM 
DFHTCT TYPE=FINAL 


* 

* 

* 

Define intersystem link* 
control information* 

* 

* 

* 

* 

* 

* 

* 

* 

Hainly a sender of reguests * 
Sends max. of 512 bytes * 
Receives max. of 512 bytes * 
Last TCTTE entry 
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The corresponding definition in the second CICS/VS system would be as 
follows;— 


DPHTCT TYPE= INITIAL, 
APPLID=CICSLA, 
ACCMETH= (VTAM) # 
SUFFIX=AC 

| CICSNY DFHTCT TYPB=SYSTEM, 

NETNAME=CICSNY, 
SYSIDNT=REM1, 
ACCMBTH=VTAM, 
TRMPRTY=100, 
OPERID^OPI, 
0PERSEC=15, 
OPERPRI=50, 
TRMIDNT=NYG1, 

| TRMSTAT=TRANSCEIVE, 

SE STYPE=RECEIVE, 
R0SIZE=512, 
BUFFER=512, 
LASTTRM=VTAM 
DFHTCT TYPE=FINAL 


4c 

4c 

* 

♦ 

4c 

* 

* 

♦ 

* 

♦ 

♦ 

♦ 

♦ 

MAINLY RECEIVES REQUESTS * 

♦ 

* 


I MULTIREGION OPERATION 


| The first CICS/VS system is defined as follows: 


I * 


DFHTCT TYPE=INITIAL, 

APPLID=CICSA 
DFHTCT TYPE=SYSTEM, 

NETNAME=CICSB, 
SYSIDNT=CICB , 

ACCMETH=IRC, 

TRMPRTY=100, 

SEND= (SB, 3) , 

RECEIVE= (RB, 2) , 

TRMSTAT^ *OUT OF SERVICE*, 

TIOAL= (300) , 

XSNAME=0PA, 

OPERSEC=15, 

OPERPRI=35, 

OPERRSL=1 


♦ 

4c 

4c 

4c 

4c 

4t 

3 outbound sessions * 
2 inbound sessions * 
sessions to be initially * 
unusable * 
min TIOA size for sessions * 

4c 

4c 

4c 


| The second CICS/VS system is defined as follows: 




DF HTCT T YPE=INITIAL, 
APPLID=CICSB 
DFHTCT TYPE=SYSTEM, 

NETNAME-CICSA, 
SYSIDNT=CICA, 
ACCMETH=IRC, 
SEND= (SA, 2) , 
RECEIVE= (RA ,3) , 


correspond to A*s RECEIVE sessions * 
correspond to A*s SEND sessions * 
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The following example for multiregion operation includes the use of a 
copy book for the definition of terminals known to both systems. 


TITLE •DFHTCTA1 PRODUCTION SYSTEM TCT 9 
*********************************************************************** 


* * 

* THIS IS ONE OF TWO SAMPLE TCTS CODED FOR AN INSTALLATION THAT USES * 

* MULTI REGION OPERATION. THE INSTALLATION IS ASSUMED TO BE RUNNING * 

* A PRODUCTION CICS SYSTEM WITH A NETWORK NAME OF PRODSYS AND A TEST * 

* CICS SYSTEM WITH A NETWORK NAME OF TESTSYS * 

* * 

* PRODSYS HAS A VTAM TERMINAL (L77A), A BTAM TERMINAL (L77B) AND A * 

* CONSOLE (CNA1). * 

* TESTSYS HAS A CONSOLE (CNA2) AND KNOWS ABOUT L77A AND L77B ON * 

* PRODSYS. * 

* * 

* TERMINAL OPERATORS ON L77A OR L77B CAN RUN TRANSACTIONS IN PRODSYS * 

* OR TESTSYS DEPENDING ON WHETHER THE TRANSACTION ID THEY ENTER IS * 

* DEFINED IN PRODSYS* S DFHPCT TO BE LOCAL OR REMOTE. PRODUCTION * 

* TRANSACTION IDS ARE LOCAL AND THOSE UNDER TEST ARE REMOTE. * 

* * 

EJECT 

DFHTCT TYPE=INITIAL, * 

SUFFIX=A1, * 

RAMIN=20, * 

RAMAX=512, * 

RATIMES=16, * 

RAPOOL=3, * 

RESP=FME, * 

ACCMETH=(VTAM,NONVTAM), * 

APPLID=PRODSYS, UNIQUE NETWORK NAME OF THIS CICS * 

SYSIDNT=PROD NAME BY WHICH WE KNOW OURSELVES 

* 

*********************************************************************** 

* DEFINE OUR CONSOLE * 

*********************************************************************** 

* * 
CONA1 DFHTCT TYPE=SDSCI,DEVICE=CONSOLE 

CONSLA1 DFHTCT TYPE=LINE,ACCMETH=SEQUENTIAL,INAREAL=80,TRMTYPE=CONSOL£ 
CONTA1 DFHTCT TYPE=TERMINAL,TRMIDNT=CNA1,TRM STAT=TRANSCEIVE 
* 


*********************************************************************** 


♦ DEFINE THE LINKS TO THE OTHER SYSTEM. * 

*********************************************************************** 

* 

DFHTCT TYPE=SYSTEM, * 

ACCMETH=IRC, INTERCOMMUNICATION SVC * 

NETNAME=TESTSYS, UNIQUE NETWORK NAME OF OTHER SYSTEM * 

SYSIDNT=TEST, NAME BY WHICH PRODSYS KNOWS TESTSYS * 

SEND= (S2,2) , TWO SEND LINKS CALLED S21 AND S22 * 

RECEIVE= (R2,2), TWO RECEIVE LINKS R21 AND R22 * 

TI0AL=512 

* 

*********************************************************************** 

* DEFINE THE TERMINALS OWNED BY THIS SYSTEM. * 

* USE OF DFHTCT TYPE=REGION MACROS ALLOWS THE SOURCE FOR THE * 

* TERMINALS KNOWN TO BOTH SYSTEMS TO BE KEPT IN A COPY BOOK * 

* USED BY BOTH TCTS. * 


*********************************************************************** 

* 

COPY TCTTERMS TERMINALS KNOWN TO BOTH SYSTEMS 

* 
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♦ FURTHER DEFINITIONS COULD FOLLOW OF TERMINALS 

♦ KNOWN TO PRODSYS BUT NOT TO TESTSYS. 

♦ 

DFHTCT TYPE=FINAL 
END DFHTCTBA 


TITLE 1 DFHTCTA2 TEST SYSTEM TCT 1 

DFHTCT TYPE-INIT IA L , * 

SUFFIX= 1 A2 , * 

RAMIN=20 t * 

RAMAX=512 , * 

RATIMES=16, * 

R APOOL=3/ ♦ 

RESP=FME, * 

ACCMETH= (VTAM , NONVTAM) # * 

APPLID=TESTSYS , UNIQUE NETWORK NAME OF THIS CICS * 

SYSIDNT=TEST NAME BY WHICH WE KNOW OURSELVES 

* 

*********************************************************************** 

* DEFINE OUR CONSOLE * 

*********************************************************************** 

* * 

DFHTCT TYPE=SDSCI r DEVICE=CONSOLE 

DFHTCT TYPE=LINE, ACCMETH=SEQUENTI&L,INAREAL=80 f TB!irYPE=CONSOLE 
CNA1 DFHTCT TYPE=TERMINAL,TfiMIDNT=CNA2 f TRMSTAT=TRANSCEIVE 

* 

****************** ******************************:****: ******************* 

* DEFINE THE LINKS TO THE OTHER SYSTEM. * 

* ********************************************************************** 

* 


DFHTCT TYPE=SYSTEM, 
ACCMETH=IRC, 
NETNAME=PRODSYS, 
SYSIDNT=PROD , 
SEND=(S1,2), 
RECEIVE= (R 1,2) , 
TIOAL=512 


* 

INTERCOMMUNICATION SVC * 
UNIQUE NETWORK NAME OF OTHER SYSTEM * 
NAME BY WHICH TESTSYS KNOWS PRODSYS * 
TWO SEND LINKS CALLED S11 AND S12 * 
TWO RECEIVE LINKS R11 AND R12 * 


*********************************************************************** 

* DEFINE THE TERMINALS OWNED BY PRODSYS BUT KNOWN TO TESTSYS. * 

* USE OF DFHTCT TYPE=REGION MACROS ALLOWS THE SOURCE FOR THE * 

* TERMINALS KNOWN TO BOTH SYSTEMS TO BE KEPT IN A COPY BOOK * 

* USED BY BOTH TCTS. * 

*********************************************************************** 

* 


* 

* 


DFHTCT TYPE=REGION,SYSIDNT=PROD 

COPY TCTTERMS TERMINALS KNOWN TO BOTH SYSTEMS 

DFHTCT TYPE=FINAL 
END DFHTCTBA 


* TCTTERMS COPY BOOK 

* 

L77A DFHTCT TYPE=TERMINAL,TRMIDNT=L77A,TRMTYPE=L3277,TRMMODL=2, * 

CLASS= (CON V, VIDEO) ,TIOAL= 1500,RELREQ= (YES,YES) , * 

FEATURE^ (SELCTPEN,AUDALARM,UCTRAN), * 

ACCMETH=VTAM,TCTUAL=8, * 

CON NECT=AUTO ,TRMSTAT= (TRANSCEIVE) 
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* 

* NOTE THAT TYPB=SDSCI MACHOS DO NOT GENERATE ANYTHING IF THE 

* CURRENT REGION IS REMOTE TO THE SYSTEM THIS IS BEING 


♦ ASSEMBLED FOR. 

♦ 

DFBTCT TYPE=SDSCI, * 

CU=3272, * 

DEVICE=L3277, * 

LINELST= (035) , * 

DSCNAME=DDA11, * 

BSCODE=EBCDIC 

* 


* NOTE THAT TYPE=LINE MACROS DO NOT GENERATE ANYTHING IF THE 

* ASSOCIATED TERMINAL IS REMOTE TO THE SYSTEM THIS IS BEING 

* ASSEMBLED FOR. HOWEVER, THE DEFAULTS SET UP FOR SUBSEQUENT 

* TERMINAL MACROS STILL TAKE EFFECT (IE ACCMETH AND TRMTYPE). 


* 

DFHTCT TYPE=LINE , * 

ACCMETH=BTAM, * 

TRMTYPE=L3277, * 

DSCNAME=DDA11 , * 

INAREAL=512, * 

TRMMODL= : 2 , * 

BTAMRLN=1, * 

POOLADR=L77B, * 

BSCODE=EBCDIC, * 

DUMMY=DUMMY 

L77B DFHTCT TYPE=TERMINAL, * 

TRMIDNT=L77B, * 

LVUNIT=1, * 

FEATURE= (SELCTPEN, UCTRAN , AUDALARM ) , * 

TRMSTAT=TRANSCEIVE, * 

LASTTRM=POOL , * 

TCTUAL=8,TIOAL=80 


DL/I SHARED DATABASE SUP PORT (CICS/OS/V S) 


TYPE=INITIAL, 


* 

ACCMETH= (NONVTAM) , 

NO VTAM TERMINALS 

* 

or (VTAM), 

VTAM TERMINALS 

* 

SUFFIX=AA r 


* 

APPLID=CICSA 

NAME USED FOR CICS/VS 

* 


IN "CICS" OPTION OF 

* 


BATCH EXEC PARAMETER 

* 

DFHTCT TYPE=IRCBCH , 

COMMUNICATION WITH 

* 


BATCH REGION 

* 

SESNUMB=3 

NO MORE THAN 3 BATCH 

♦ 


REGIONS CAN SHARE 

♦ 


DL/I DATA BASES WITH 

* 


CICS/OS/VS AT SAME 

* 


TIME 

♦ 
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LUTYPE4 LOGICAL UNIT 


DFHTCT TYPE=INITIAL, * 

ACCMETH=VTAM, VTAM generation * 

APPLID=CICS f Network name of CICS * 

StJFFIX=xx 

DFHTCT TYPE=TERMINAL, * 

TRMIDNT=WPT1, * 

TRMTYPE=LUTYPE4 , * 

ACCMETH=VTAM , * 

TIOAL= (256,1024) , * 

CHNASSY=YES, * 

NETNAME=REMWPT1, * 

CONNECT=AUTO, * 

TRMSTAT=TRANSCEIVE, * 

TRMPRTY=100, * 

HF=YES, * 

VF=YES, * 

FF=YES, * 

LDC=(CO,R1,P1,W1,W2,W3) Local LDC list 
DFHTCT TYPE=LDC, * 

LDC=SYSTEM System LDC list 

DFHTCT TYPE=FINAL 


| PROCESSING UNIT CONSOLE (OS/VS) 


| DFHTCT TYPE=TERMINAL, * 

| TRMIDNT=CNSL, * 

| TRMTYPE=CONSOLE, * 

| TIOAL=119, * 

| CONSLID=22, * 

| TRMSTAT=TRANSCEIVE, * 

| TRMPRTY=100, * 

| TCTUAL=0 * 

| OPERID=SWW, * 

| OPERPRI=0 * 

| OPERSEC=1, * 

| PGESIZE=(6,80) , * 

| LPLEN =80 

| DFHTCT TYPE=FINAL 


| DFHTCT TYPE=GPENTR Y 
| Example 1: 

| The table below describes a network of two local 3277s and a 3284 printer 


1 

OPERAND 

TERMINAL 1 

TERMINAL 2 

PRINTER 


LINBLST 

010 

011 

012 


TRMMODL 

1A 

2 A 

2B 


TRMFEAT 

ADU 

ADSU 

P 


TRMIDNT 

L77 A 

L77B 

L84A 


TRMUAL* 

0 

0 

0 


TRMPRTY 

100 

100 

100 

1 

* TRMUAL 

defaults to 0, and 

since all values are 

zero. 


| this parameter may be omitted. 
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| The following example defines the line group described in the above table: 


DFHTCT TYPE=INITIAL, 

♦ 

SUFFIX=LC, 

MODNAMB=BTMODL 

* 

DFHTCT TYPE=GPENTRY, 

* 

GPTYPE=3270L, 

* 

LININL=50, 

* 

LINELST= (010,011,012) , 

* 

TRMM0DL= (1 A, 2A ,2B) , 

* 

TRMFEAT= (ADU , ADSU ,P) , 

* 

TRMIDNT= (L77A,L77B,L84A) , 

TRMPRTY= (100,100) 

DFHTCT TYPE=FINAL 

END 

♦ 


| Example 2: 


Host 


I 

| 2703 | 


SYS020 


SYS021 


lation 


1 3271 

i 

—| X 

| WRAPLIST 

j 

j 3271 i 

1 _ 1 

1 

1 

1 


1 

1 

1 

1 

1 

1 


1 

1 

1 

1 

1 

1 


| •B77C*I 
| 3277 | 

L 1 

! 



i 

I 

i 

l 

| , B77A‘i 
| 3277 | 

i i 

j *B77B•j 

1 3277 | 

• . > 

| *R86A 1 | 
| 3286 | 

i i 

Alarm 

Dual Case 
U/C Trans— 

Alarm 

Dual Case 
U/C Trans— 

Printer 


lation 

Selector Pen 


I 


NOCOPY 


COPY 


| 3271 | OPENLST 


I 


I 


I 


I 


Alarm 
Dual Case 
U/C Trans¬ 
lation 


| *R78B»| 
| 3278 | 

i_i 


|*R78C•| |•R87A 1 | 

| 3278 | | 3287 | 


Alarm Alarm 

Dual Case Dual Case 
U/C Trans— U/C Trans¬ 
lation lation 

Selector Selector 
Pen Pen 


Printer 
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| The following example defines the configuration illustrated above: 


DFHTCT TYPE=IHITIAL, 


♦ 

MODHAME=BTHODR 

OSIHG 3270 REMOTE BTMOD 


DFHTCT TYPE=GPEHTBY, 
GPTYPB=C0NS0LE, 

COHSOLE SOPPORT 

* 

TBMIDHT=CHSL, 

TERMINAL HAHE 

♦ 

TRMPBTY=50, 

TERMIHAL PRIORITY 

♦ 

LIHIHL=80 

TIOA LEHGTH 


DFHTCT TYPE=GPEHTBY, 


* 

GPTYPB=3270BE, 

REMOTE 3270 EBCDIC 

* 

GPTC0=2703, 

CONTROLLER is 2703 

* 

LIHELST=(020,021) , 

OH SYS020 and SYS021 

* 

LIHFEAT=(,0) , 

SYS021 OPEN LIST POLLING 

♦ 

C0ADDB= (0,1,0), 

2 COS ON LINE 1, 1 CO OH LINE 2 

* 

C0FBAT= (C,,C), 

1ST AND 3RD HAVE COPY 

* 

COPOSH= (1,1,2), 

1 CO ON SYS021,2 OH SYS020 

♦ 

ALTSCRN=(,,,,(12,80),(32,80),(43,80),(43,80)), ALTSCB 

* 

ALTSFX= (1,2,3, 4,5,6 

,7,8), HAPSET SOFFIXES 

♦ 

TBMADDB= (0,1,2,0,0, 

1,2,3), 3 TERMS OH 1ST CO, 1 ON 2ND 

* 


TRHFEAT= (ADO,ADSO,P,,ADO,ADSO,ADSO,P) , TERMNL FEATORES * 
TRMIDHT=(B77A,R77B,R86A,R77C,R78A,R78B,R78C,R87A), HAHE* 
TRMINL= (50,50,0,50,100,100,100,0), TIOA SIZES * 

TRMMODL=(2A,1A,2C,1A,1A,2A,2A,2B), MODEL TYPES * 

TRMPOSN=(1,1,1,2,3,3,3,3), 3 ON CO 1,1 OH C02,4 OH C03 * 
TRMPBTY= (50,50,50,25,100,100,100,100), TBMHL PRIORITIES* 
TRMOAL= (75,75,75,0,0,0,0,0) TBMHL TCTOA SIZE 

DFHTCT TYPE=FIHAL 
EHD 
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Appendix C. Program Generation Summary 


The following are the modules generated by the various CICS/VS system 
generation macros. 


SYMBOLIC 

SUFFIX- 


DFBSG 

NAME 

ABLE 

PROGRAM NAME 

PROGRAM^ 

DFHACEE 


Security ID program 

CSS 

DFBACP 


Abnormal Condition 

CSO 

DFBAKP 


Activity Key Point 

KPP 

DFHALP 


Allocation Program (Terminal Resources) 

KCP 

DFHAQP 


Asynchronous Queue Purge 

ATP 

DFHASV 


Page Fix/Free SVC routine 

INITIAL 1 

DFHATP 


Asynchronous Transaction Control 

ATP 

DFHBFP 3 

Yes 

Built-In Function 

BFP 

DFHBMSMM 


BMS Pre—VS Compatibility 

BMS 

DFHCAA70 5 


7770 Channel Appendage program 

CSO 1 

DFHCCMF 


Periodic Monitoring program 

CSO 

DFHCMON 


Start/Stop Monitoring program 

CSO 

DFHCMP 


Monitoring Program 

CSO 

DFHCPY 


VTAM 3270 Print Function Support 

TCP 

DF BCR C 


IRC CICS/OS/VS STAE exit 

CSO 1 

DFBCRNP 


Interregion Connection manager 

ISC 

DFHCRP 


Relay program 

ISC 

DFHCRQ 


ATI Purge program 

ISC 

DFHCRR 


Interregion Recovery 

ISC 

DFHCRS 


Remote Scheduler 

ISC 

DFHCRSP 


Interregion Control Initialization 
module 

ISC 

DFHCSA 

Yes 7 

Common Systems Area 

CSA 

DFHCSVC 6 


Bootstrap Type 2 SVC 

INITIAL 1 

DFHCWTO 


Console-write—to—operator (CICS/DOS/VS) 

CSO 2 

DFHDBP 

Yes 

Dynamic Transaction Backout 

DBP 

DFBDCP 3 

Yes 

Dump Control 

DCP 

DFBDCSA 


INITIAL Load 

CSA 1 

DFHDEB70 


7770 Device End program 

CSO 1 

DFHDIP 3 

Yes 

Batch Data Interchange program 

DIP 

DFHDLI 4 


DL/I Interface 

CSO 1 

DFHDLIAI 


DL/I Application Interface stub 

EIP 1 

DFHDLQ 


IMS/VS Quasi—Application program 

CSO 1 

DFHDP 


CICS/DOS/VS System Dump program 

CSO 2 

DFHDRP 


DL/I Shared Data Base Bootstrap program 

ISC 1 

DFHDRP (A—F) 


DL/I Shared Data Base batch modules 

ISC 1 

DFHDSB 3 

Yes 

Data Stream Builder 

BMS 

DFHDSCTS 


CICS/VS Dummy Sections 

INITIAL 

DFHDUP 


Dump Utility 

CSU 

DFHEAI 


Assembler EXEC link-edit stub 

EXP 

DFHEAIO 


Assembler EXEC link-edit stub 

EXP 

DFHEAP 

Yes 

Assembler EXEC Interface Translator 

EXP 

DFHEBF 


EXEC BFP module 

EIP 

DFHEBU 


ISC (FMH Building) 

EIP 

DFHECI 


COBOL EXEC Interface Link-edit Stub 

EXP 

DFHECID 


Command Interpreter 

EIP 

DFHECIP 


CECI Initialization 

EIP 

DFBECP 

Yes 

COBOL EXEC Interface Translator 

EXP 

DFHECSP 


CECS Initialization 

EIP 

DFHEDC 


EXEC DCP module 

EIP 

DFHEDFD 


EDF Display program 

EIP 1 

DFHEDFF 


EDF Function Table 

EIP 1 
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1 

DFBEDFM 


EDF Hap Set 

EIP 1 

1 

DFHEDFP 


EDF Control program 

BIP 1 

1 

DFHEDFR 


EDF Response Table 

EIP 1 

1 

DFHEDFX 


EDF Task Switch program 

EIP 1 


DFHEDX 


EXEC DIP module 

EIP 


DFHEEI 


EXEC EIP module 

EIP 

1 

DFHEEX 


ISC (FHH Extraction) 

EIP 


DFHEFC 


EXEC FCP module 

EIP 


DFHEIC 


EXEC ICP module 

EIP 


DFHEIP 


EXEC Interface program 

EIP 


DFHEJC 


EXEC JCP module 

EIP 


DFBEKC 


EXEC KCP module 

EIP 


DFBELR 

Tes 

EXEC Local/Remote module 

ISC 

1 

DFHEMA 


Master Terminal program 

EIP 

1 

DFHEMB 


Master Terminal program 

EIP 

1 

DFHEMC 


Master Terminal program 

EIP 

1 

DFBEMD 


Master Terminal program 

EIP 

1 

DFHEME 


Master Terminal program 

EIP 

1 

DFBEMF 


Master Terminal program 

EIP 

i 

DFHBMG 


Master Terminal program 

EIP 


DFHEMS 


EXEC BMS module 

EIP 

1 

DFHEMTD 


Enhanced Master Terminal 

EIP 

1 

DFHBMTP 


CEMT Initialization 

EIP 

1 

DFBEOTP 


CEOT Intialization 

EIP 


DFHEPC 


EXEC PCP module 

EIP 


DFBEPI 


PL/I EXEC Interface Link-edit stub 

EXP 


DFBEPP 

Yes 

PL/I EXEC Interface Translator 

EXP 

1 

DFBERI 


RPG II EXEC Link—edit stub 

EXP 2 

1 

DFBERP 

Yes 

RPG II EXEC Interface translator 

EXP 2 


DFBESC 


EXEC SCP module 

EIP 


DFBESP 


EXEC SPP module 

EIP 

1 

DFHESTP 


CEST Initialization 

EIP 


DFHETC 


EXEC TCP/ZCP module 

EIP 


DFHETD 


EXEC TDP module 

EIP 


DFHETR 


EXEC TRP module 

EIP 


DFBETS 


EXEC TSP module 

EIP 


DFBEXI 


VTAM 3270 Print Function Support 

TCP 

1 

DFHFCD 

Yes 

File Control ISAM/BDAM module (OS/VS) 

FCP 1 


DFBFCP 3 

Yes 

File Control 

FCP 


DFHFDP 


Formatted Dump Program 

CSO 

1 

DFHFED1 


FBRS Display program 1 

CSO 2 

1 

DFHFED2 


FEES Display program 2 

CSO 2 

1 

DFBFELG 


FEES Logger program 

CSO 2 


DFHFEP 


FE Terminal Test program 

css 

1 

DFBFERR 


FBRS Record Reorganization program 

CSO 2 

1 

DFBFETX 


FEES Text Display program 

CSO 2 


DFHFIP 

Yes 

FASTER/Compat program 

BMS 


DFHFTAP 


Format Tape program 

KPP 


DFHF2P 

Yes 

Basic Mapping FASTBR/Compat 

BMS 

1 

DFHGAP 


Graphics Attention program 

GAP 1 

1 

DFHGAPNA 


Graphics Attention Alias 

GAP 1 


DFHGMM 


VTAM Good Morning Message program 

TCP 

1 

DFHHPSVC 


SRB type 6 SVC 

INITIAL 1 


DFBICP 

Yes 

Interval Control Program 

ICP 


DFHIIP 3 

Yes 

Non—3270 Input Mapping 

BMS 


DFHIRP 


Interregion Control program 

ISC 


DFEISP 

Yes 

Inter communication pro gram 

ISC 


DFBJCBSP 


Journal Tasks Bootstrap program 

JCP 


DFHJCC 


Journal Control Close 

JCP 


DFBJCBO> 


Journal Control BOV 

JCP 


DFBJCI 


Journal Control Input 

JCP 


DFHJfclOE 


Journal Control I/O Error program 

JCP 


DFHJCJFP 


Journal Control Format program 

JCP 


DFHJCKOJ 


Journal Control Kickoff program 

JCP 


DFBJCO 


Journal Control Open 

JCP 
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DFHJCOCP 


Journal Control Open/Close program 

JCP 


DFHJCP 3 

Tes 

Journal Control 

JCP 


DFHJCSDJ 


Journal Control Shutdown 

JCP 


DFBKCP 

Yes 

Task Control 

KCP 

1 

DFHKCSP 


SRB Service Program 

KCP 1 


DFHKPP 3 

Yes 

Keypoint 

KPP 


DFHLFO 


LIFO Storage program 

CSO 

1 

DFHMCE 

Yes 

Entry Level Mapping program 

BMS 2 


DFHMCP 3 

Yes 

Mapping Control 

BMS 


DFHMGP 


Error message program 

CSO 


DFHMGT 


Error message table 

CSO 


DFHMIR 


ISC Mirror module 

ISC 


DFHMSP 


Message Switching program 

CSO 


DFHMTPA 


Master Terminal program Module A 

MTP 


DFHMTPB 


Master Terminal program Module B 

MTP 


DFHMTPC 


Master Terminal program Module C 

MTP 


DFHMTPD 


Master Terminal program Module D 

MTP 


DFHMTPB 


Master Terminal program Module E 

MTP 


DFHMTPF 


Master Terminal program Module F 

MTP 


DFHMTPG 


Master Terminal program Module G 

MTP 

1 

DFHMXP 


Local Queuing Shipper program 

ISC 


DFHM32 3 

Yes 

BMS 3270 Mapping 

BMS 


DFHOCP 


Open/Close 

OCP 


DFflPBP 3 

Yes 

BMS Page Build program 

BMS 


DFHPCP 

Yes 

Program Control 

PCP 


DFHPEP 


Program Error Dummy program 

CSO 


DFHPHN 


Phonetic Code Conversion (Offline) 

BFP 

1 

DFHPLP 


Program Load program 

CSO 2 


DFHPRK 


VTAM 3270 Print Function Support 

TCP 


DFHPRPR 


HLL Preprocessor 

HLL 


DFHP3270 


3270 Print Function Support 

TCP 


DFHRD1 


ATP Input Processor, Phase 1 

ATP 


DFHRD2 


ATP Input Processor, Phase 2 

ATP 


DFHRKB 


VTAM 3270 Print Function Support 

TCP 


DFHRLR 3 

Yes 

BMS Route List Resolution 

BMS 

I 

DFHRTE 


Transaction Routing program 

ISC 


DFHRTY 


CICS/VS—supplied Transaction Restart 

DBP 




module 



DFHROP 


Recovery Utility program 

KPP 

1 

DFHRWP70 


7770 Read/ffrite 

CSO 1 

1 

DFHSCE 

Yes 

Entry Level Storage Control program 

SCP 2 


DFHSCP 

Yes 

Storage Control 

SCP 


DFHSCR 

Yes 

Storage Control Recovery 

SCP 

1 

DFHSCTE 


Subsystem Control Table Extension 

ISC 2 

1 

DFHSDAM 


Direct Access Logic Module (VSE) 

CSO 2 


DFHSFP 


Sign-Off program 

CSS 


DFHSIA1 


System Initialization — module A1 

CSO 


DFHSIB1 


System Initialization — module B1 

CSO 


DFHSIC1 


System Initialization — module Cl 

CSO 


DFHSID1 


System Initialization — module D1 

CSO 


DFHSIE1 


System Initialization — module El 

CSO 


DFHSIF1 


System Initialization — module FI 

CSO 


DFHSIG1 


System Initialization — module G1 

CSO 


DFHSIH1 


System Initialization — module HI 

CSO 


DFHSII1 


System Initialization — module 11 

CSO 


DFHSIJ1 


System Initialization — module J1 

CSO 


DFHSIP 


System Initialization 

CSO 


DFHSNP 


Sign—On program 

css 


DFHSPP 


Sync Point program 

KCP 


DFHSRP 3 

Yes 

System Recovery 

SRP 


DFHSTKC 


Supervisor Statistics 

CSO 


DFHSTLK 


ISC Link statistics program 

CSO 


DFHSTP 


System Termination 

CSO 


DFHSTPD 


Program and Dump Statistics 

CSO 


DFHSTSP 


Auto. Statistics Summarization Control 

CSO 
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DFHSTTD 


Data Management Statistics 

CSO 


DFHSTTR 


File and Terminal Statistics 

CSO 


DFHSTUP 


Auto. Statistics Summarization Utility 

CSU 


DFHTACP 


Terminal Abnormal Condition 

CSO 


DFHTAJP 


Time of Day Adjustment 

CSO 

1 

DFHTBP 

Yes 

Transaction Backout program 

TBP 


DFHTCP 

Yes 

Terminal Control Program 

TCP 

1 

DFHTDP 3 

Yes 

Transient Data Program 

TDP 


DFHTDRP 


Transient Data Recovery program 

KPP 


DFHTEOF 


Tape End of File program 

KPP 


DFHTEP 


Terminal Error Dummy program 

CSO 

1 

DFHTPP 3 

Yes 

BMS Terminal Page program 

BMS 


DFHTPQ 


BMS Terminal Page Clean-up 

BMS 


DFHTPR 


BMS Terminal Page Retrieval 

BMS 


DFHTPS 


BMS Delayed Message Delivery 

BMS 

1 

DFHTRP 3 

Yes 

Auxiliary Trace program 

TRP 

1 

DFHTSP 3 

Yes 

Temporary Storage Program 

TSP 


DFHTSRP 


Temporary Storage Recovery program 

KPP 


DFHTUP 


Trace Utility program 

CSU 

1 

DFHUEH 


User Exit Handler 

CSO 

1 

DFHUEM 


User Exit Manager 

CSO 


DFHWT1 


ATP Output Processor, Phase 1 

ATP 


DF3WT2 


ATP Output Processor, Phase 2 

ATP 


DFHXFP 

Yes 

ISC Transformer program 

ISC 


DFHXFQ 


DL/I Shared Data Base Transformer 

ISC* 




program 


1 

DFHXSP 3 

Yes 

Security program 

CSS 

1 

DFHXSS 


SVC link module to RACF 

CSS* 

1 

DFHXTP 

Yes 

Transaction Routing Transformer 

ISC 


DFHZCA 


VTAM Terminal Control program module 

TCP 


DFHZCB 

Yes 

VTAM Terminal Control program module 

TCP 

1 

DFHZCNC 


Console-write-to—operator (CICS/OS/VS) 

TCP* 


DFHZCP 

Yes 

Common Terminal Control program module 

TCP 


DFEZCX 

Yes 

Common Terminal Control program module 

TCP 


DFHZCY 


VTAM Terminal Control program module 

TCP 


DFHZCZ 

Yes 

VTAM Terminal Control program module 

TCP 

1 

DFHZHPRX 


RPL Executor in SRB Mode 

TCP* 


DFHZNAC 


Mode Abnormal Condition program 

TCP 


DFHZNEP 


Node Error Program Interface program 

TCP 


DFHZRLG 


Response Logging program 

TCP 


DFHZRSP 


Resend program 

TCP 

1 

PLISHRE 


PL/I Shared Library Transfer Vector 

HLL* 


* CICS/OS/VS Only. 

| 2 separately generated for VSE. Refer to the CICS/VS Syste m 

Programmers Guide (DOS/VS) . 

| 3 Dummy program name may be generated. Refer to ,f CSD — Control 

| System Dummy Group 11 in Chapter 2.2. 

| 4 Dummy program name may be generated. Refer to ”CSO — Control 

| System Operational Group” in Chapter 2.2. 

| 5 Link edited as IGG019xx, where xx is the appendage suffix 

| specified in the CAA operand of the DPHSG PROGRAM=CSO macro. 

| 6 Link edited into nucleus as IGCxxx, where xxx is the value given 

i to CICSSVC. 

| * Suffixable on CICS/OS/VS only. 
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Appendix D. CICS/VS St a t istics 


The information in this appendix shows the types of statistics that can 
be produced under CICS/VS. For details on the commands that have to be 
entered to produce these statistics, refer to the information under 
transaction CSTT in the CICS/VS Operator^ Guide * 


S TATISTICS PRODU CED 


All the statistics in the following lists are included in both requested 
and automatic statistics, with the exception of those bearing the 
notation "AS only 11 . Such a notation indicates automatic statistics 
only. 

The statistical information is necessary not only to indicate the 
actual performance of the CICS/VS system during operation, but also for 
managements planning for future system growth. The statistics are 
useful to: 

• Help the system programmer determine that efficient data set 
allocation has been made. 

• Aid the system programmer in choosing programs to be made 
permanently resident during system initialization processing, as 
opposed to those programs CICS/VS is to load dynamically. 

• Determine the activity of terminals and transactions. 

• Reorder the sequence of entries in various CICS/VS tables, to 
ensure that the most active entries are toward the top of tables 
and thus minimize table scanning. 

• In general, determine if the resources of the system are being 
effectively used. 


TASKS 

For the entire system: 

• Maximum number of tasks allowed (max task) (AS only) 

• Peak number of tasks reached 

• Number of times at max task 

• Number of tasks processed 

• Maximum number of active tasks allowed (max active task) (AS only) 

• Peak number of active tasks reached 

• Number of asynchronous transactions (ATP) 

• Number of batches (ATP) 
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For each class (numbered from 1 to 10): 

• Maximum number of tasks allowed (max class task) 

• Peak number of tasks reached 

• Number of times at max task 

STORAGE 

For the entire system: 

• Number of storage acquisitions 

• Number of storage releases 

• Number of times storage cushion released 

• Number of times storage request was queued 

• Number of times storage queue was established 

• Peak number of requests in storage queue 

• Number of storage violations 

• Number of storage requests made on the primed pool — High 
Performance Option (HPO) 

• Number of times a conditional GETMAIN request was not satisfied. 

TRANSACTIONS 

For the entire system: 

• Number of transactions accepted (AS only) 

For each transaction requested: 

• Whether the transaction was designated as long— or short—running 

• Number of times transaction reguested 

• Number of times transaction stall-purged 

• Number of times transaction was restarted 

• Number of times additional storage requested for isolated paging 

• Number of storage violations (AS only) 

• Page pool size (AS only) 
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PROGRAMS 


For the entire system: 

• Number of programs used (total use count) (AS only) 
For each program used: 

• Number of times used 

• Number of times the program was fetched 


DUMPS 


For the entire 

• Number of 

• Number of 


system: 
storage dumps 
dump Write errors 


TERMINALS 

For each line: 

• Number of poll completions 

For each terminal (including ISC and IRC sessions): 

• Number of input messages 

• Number of output messages 

• Number of transmission errors (for IRC, number of times session has 
been disconnected) 

• Number of transactions since last sign-off (see Note) 

• Number of transaction errors since last sign—off (see Note) 

• SNA — peak number of RPLs posted on any one dispatch of Terminal 
Management 

• SNA - number of times RPL maximum was reached 

• SNA — VTAM short-on—storage count 

• Number of storage violations 

• Pipeline — number of messages discarded 

• Pipeline — peak number of consecutively discarded messages 

• Pipeline — number of times consecutive messages discarded 

Note : When an operator signs off at a terminal, message DFH3601 

containing the following fields; ^number of transactions” and "number of 
transaction errors" is sent to the current transient data destination. 
These fields are then reset to zero. 
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The above statistics are also available in summary report form (for 
example, the number of output messages for the entire system) (AS only) 


DATA BASE DATA SETS (FILES) 

In systems connected by a CICS/VS intersystem communication link, the 
statistics recorded for the remote data base files are a subset of the 
statistics recorded for the local data base files. 

For each local data base data set: 

• Number of GET requests 

• Number of GET for UPDATE requests 

• Number of BROWSE (G ETN E XT,GETPREV) requests 

• Number of ADD requests 

• Number of UPDATE requests 

• Number of overflow records read (ISAM files only) 

• VSAM — number of DELETE requests 

• VSAM — number of requests that waited for a string 

• VSAM — peax number of requests that waited for a string 

• Number of requests that waited for a buffer in VSAM Resource Pool 

(VHP) (AS only) 

• Peak number of requests that waited for buffers in VRP (AS only) 
For each segment: 

• Number of times segment used (if any) 

Note : The above statistics are also available in summary report form 
(for example , number of READ requests for the entire system). (AS only) 

For each remote data base data set: 

• Number of READ requests 

• Number of ADD requests 

• Number of UPDATE requests 

• VSAM — number of DELETE requests 

DL/I DATA BASES (OS/VS ONLY) 

For each data base: 

• Number of GU (Get Unique) requests 

• Number of GN (Get Next) requests 
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• Number of GNP (Get Next within Parent) requests 

• Number of GHU (Get Hold Unique) requests 

• Number of GHN (Get Hold Next) requests 

• Number of GHNP (Get Hold Next within Parent) requests 

• Number of ISRT (Insert) requests 

• Number of DLET (Delete) requests 

• Number of REPL (Replace) requests 

• Number of requests of all types above 

VSAM SHARED RESOURCES 

For the entire system: 

• Maximum key length specified 

• Number of strings specified 

• Peak number of requests that waited for a string 

• Number of requests that waited for a string 

• Peak number of concurrently active strings 

• Total number of buffers allocated (AS only) 

• Total buffer space allocated (AS only) 

For each control interval: 

• Number of successful look—asides (CICS/OS/VS only) 

• Number of buffer READ requests (CICS/OS/VS only) 

• Number of buffer WRITE requests (CICS/OS/VS only) 

• Number of buffers (AS only) 

For each data set that shares resources: 

• Number of requests that waited for a buffer 

• Peak number of requests that waited for a buffer (AS only) 

Note : DL/I statistics are not included in the VSAH shared resources 

statistics. 
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TRANSIENT DATA 


For the entire system: 

• Number of tracks used for intrapartition transient data 
For each destination identification (ID): 

• Number of extrapartition outputs 

• Number of intrapartition outputs 

• Number of indirect destination outputs 

• Number of automatic transaction initiation outputs 

• Number of remote outputs 

Note : The above statistics are also summarized for all destinations 
(AS only) 

TEMPORARY STORAGE 
For the entire system: 

• Number of PUT/PUTQ requests to main storage 

• Number of PUT/PUTQ requests to auxiliary storage 

• Number of PUT requests to both main and auxiliary storage 

• Number of PUTQ requests to both main and auxiliary storage 

• Number of message queues created 

• Number of TSGID extensions created 

• Peak virtual storage used (TSMAIN) 

• Number of times auxiliary storage was exhausted 

• Number of times the temporary storage data set was compressed 

• Number of times an I/O error occurred 

• Number of control intervals available 

JOURNALS 

For each journal: 

• Number of records written 

• Number of blocks written 

• Number of times the buffer was full 

• Number of times the block shifted up 
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Average output block size 


DYNAMIC TRANSACTION BACKOUT 

• Number of records logged by Dynamic Transaction Backout 

• Number of records spilled to temporary storage 

INTERCOMMUNICATION FACILITIES 

Session request management: 

• Total number of AIDS 

• Number of non-specific AIDs 

• Number of current BIDs 

• Maximum number of BIDs 

• Number of ATIs satisfied by the secondary 

• Maximum number of secondaries 

• Number of ATIs satisfied by the primary 

• Total BIDs sent 

Reguests for session TCTTE allocation: 

• Total number of allocation requests 

• Number of allocation requests queued 

• Maximum number of allocation requests outstanding 

• Number of allocation requests failed for reasons concerned with the 
link 

• Number of allocation requests failed for other reasons 
Requests for remote services 

• Number of File Control requests 

• Number of Interval Control requests 

• Number of Transient Data requests 

• Number of Temporary Storage requests 

• Number of DL/I requests 

• Number of transaction routing commands 
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INTERREGION COMMUNICATION (0S/VS ONLY) 


• Maximum number of concurrent sharing batch regions (may be used to 
tune the SESNUMB value in DFHTCT TYPE=IRCBCH) 

• Total sharing batch regions (the total number of batch ••units” 
using shared data base; count 1 for each batch program, and an 
additional unit for each CHRP call issued by programs that share 
batch regions) 
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Append ix E. Error Messages and Codes 


The following appendix contains a list of error messages generated in 
DFHTACP for terminal error programs, and in DFHNACP for node error 
programs, with the corresponding error codes. 


T ERMIN AL ERRO R PROGRAM 


The following error messages, error codes, and default actions relate to 
abnormal conditions detected from BTAM and TCAM supported terminals. The 
code containing the error condition is passed to DFHTEP in a one—byte 
field of the TACLE called TCTLEPFL• Control is then passed to the 
appropriate TEP for resolution of the error. 

Before giving control to DFHTEP, DFHTACP establishes certain default 
actions to be taken, depending upon the particular error condition that 
has been detected. The default actions are indicated by appropriate bit 
settings in the one—byte field of the TACLE labeled TCTLEBCB+1 or 
TCTLEECB+2. Tne default actions and their appropriate settings are 
given at the end of this section. 


Error Code Error 

(Value) Message 

| X*81 # (TCEMCMTL) DFH2501 


| X # 83 1 (TCEMCAAR) DFH2503 
| X^^ (TCEMCTCT) DFH2502 


Action Set 

Condition By DFHTACP 

(See Notes) 

Input message exceeds read length, 

or lost data signaled 

on read text for remote device 


(follows unit check error). 3 

2740—2 auto output request. none 

TCT search error. 

• Switched line — Real 3 

terminal. 

• Switched line — Dummy none 

terminal. 

• Nonswitched line — Real 2,3 

terminal. 

• Nonswitched line — Dummy 1 

terminal. 


| X»85 f (TC EMC ROT) DFH2511 Invalid write request. 

• A write request was made to 3 

a terminal in INPUT status. 

• A write request was made to 3 

a 3735 before EOT (EOF 
condition) was received from 

the 3735 during batch 
transmission. 
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I X'86* (TCEBCPL) DFH2505 
| X *87• (TCEBC01) DFH2529 


| X *88 • (TCEBCIEB) DFH2507 

I 

| X *89' (TCEBCSB) 

DFH2526 

DFH2527 

DFH2528 

DFH2528 

DFH2528 

| X'8A* (TCEBCTO) DFB2510 
| X * 8B • (TCEBCOBE) DFH2512 

| X *8C * (TCEBCOBE) DFH2506 

I 

| X *8D• (TCEBCOLZ) DFH2513 


Polling list error. 1 

Unsolicited input. 

• Input has occurred on an none 

out-of-service terminal 

(3735) . 

• Terminal "Receive Only" 6 

(TCAB) (TCTLEECB+3 = X»03») • 

• Terminal "Out of Service" 2,6 

(TCAB) (TCTLEBCB+3 = X'04») . 

• Task has not issued a read none 

(TCAB) (TCTLEECB+3 = X'01»). 

• Ho available TCTTE from the none 

pool (TCAB) (TCTLEECB+3 = X'02') . 

BTAH return code on read. 

• Local 3270 open failure 2,3 

invalid SLN, unreliable 
information (VSE), 

device under OLTEP. 

• Local 2260. 2,3 

• All other conditions. 1,3 


Error status received from remote 
BSC device. 

• 3270 intervention required 


(printer). none 

• 3270 intervention reguired 

(screen) . none 

+ 3735 (all conditions). none 

• Operation check (other devices). 3 

• All other conditions/devices. 2,3 

7770 32-second timeout. 3,5 

Hardware buffer exceeded (shift 3 


character not properly accounted 


for). 

BTAB return code on write. 

• Local 3270 open failure, 2,3 

Invalid BLN, unreliable 
information (VSE) , 

device under OLTEP. 

• Local 2260. 2,3 

• All other conditions. 1,3 

Output length zero. 3 


754 


CICS/VS System Programmer's Reference Manual 



| X 1 8E • (XCEECH 0 A) DFH2514 
| X , 8F* (TCBMCOAE) DFH2515 

| X^O* DFH2532 

I 

I 

| X *91 * DFH2531 

| X^* (TCEMCUC) DFH2516 

| X • 95 • (TCBMCUCS) DFH2517 


f X # 96• (TCEMCUE) DFH2518 
| X *97• (TCEMCUBS) DFH2519 


No output area provided. 3 

Output area exceeded (TIOATDL 3 

value larger than output area). 

Print request gueued for IC PUT after 
unavailable printer (refer to "3270 
Unavailable Printer 11 in Chapter 4.2.) . 

IC error on unavailable printer entry 
(refer to "3270 Unavailable Printer" 
in Chapter 4.2.). none 

Unit check (actions same as TCBMCUCS) • 

Unit check (should not occur) . 


• L2260, L3270, or SAM 

1. SAM Line. 1,3 

2. L2260 or L3270 operation 

check only. 3 

3. L2260 or L3270 other sense 

(including L3270 undetermined 
unit error). 2,3 

• Bemote lines. 

• Switched line disabled 4 

(CICS/OS/VS) . 

• Intervention sense 

1. Switched line. 3,4 

2. Non-switched, real terminal. 2,3 

3. Nonswitched, dummy terminal. 1 

• Lost data on read text 3 

(message DFH2501 also issued, 

see code X , 81 i ) . 

• Data check sense 

1. Real terminal. 2,3 

2. Dummy terminal. 1 

• Timeout sense 

1. READ or WRITE TEXT command 

on start/stop device. none 

2. Other timeout, real terminal. 2,3 

3. Other timeout, dummy terminal. 1 

• All other sense 1 


Unit exception (actions same as 
(TCEMCUES ) . 

Unit exception (should not occur)• 


Switched line. 

3,4 

Real terminal. 

2,3 

Dummy terminal. 

1 


Appendix E. Error Messages and Codes 


755 



| X*98* 

(TCEMCNR) 

DFH2520 

Negative response. 





• Negative response to addressing. 

2,3 




• Negative response to ”DFH2503 
AUTO OUTPUT” message. 

none 

| X *99 * 

(TCEMCUDT) 

DFH2521 

Undetermined unit error. 





• Local 2260. 

2,3 




• Local 3270 (see code X l 94 t ). 





• All other devices. 

1,3 

| X *9B • 

(TCEMCICR) 

DFH2523 

The terminal entries on the "to” 
and "from” device did not specify 
the COPY feature (3270) . 

3 




The device address specified for 
the "to» device does not exist 
on the control unit. 

3 




The length of the COPY command 
was not specified as one. 

3 

| X *9C * 

(TCEMCIMB) 

DFH2524 

Invalid message block received. 





• An unidentified message block 
was received from a local 
or remote 3270. 

2,3 




• The type of input block 

received from a 3735 did not 
agree with the mode of the 
active transaction inquiry 
natch. 

2,3 

| X * 9D ' 

(TCEMCICM) 

DFH2525 

An incomplete message was received 
from a remote 3270. The device 
terminated transmission prior to 
message completion (that is, EOT 
received prior to ETX). 

2,3 

| X'9E* 

(TCEMCUP) 

DFH2508 

A 3270 print request was made but 
no printer was available to print 
the data. DFH2531 or DFH2532 may 
subsequently appear — see code X*91 
and ”3270 Unavailable Printer” in 
Chapter 4.2. 

none 

» 

| X•9F* 

(TCEMIDR) 

DFH2534 

TCAM has issued an invalid 
destination return code to CICS/VS. 

3 

| X 'AO • 

(TCEMCWOT) 

DFH2530 

Invalid read request: 





• A read request was issued to 
a terminal in RECEIVE status. 

3 




• A read was issued to a 3735 
terminal after an EOT 
(EOF condition) was received 
from the terminal during batch 
transmission. 

3 
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| X 1 A1 f (TC BHCXD R) 


DFH25Q9 


5 


A transaction has requested a 
DFHTC TYPE= (RESET,DISCONNECT) 
on a switched binary synchronous 
line and no EOT has been received 
from the terminal; this indicates 
more data is to follow. Terminal 
control issues a read to the 
terminal. If the EOT is not 
received on that read, the error 
code is set and passed to DFHTACP. 


Notes: 


Default 

Action Description Bit Setting Mask 


1 

2 

3 

4 

5 

6 


Line out of service 
Terminal out of service 
ABEND transaction 
Switched line disabled 
Disconnect switched line 
Release TCAM incoming message 


X l 80* at TCTLEBCB+1 
X*08• at TCTLEECB+1 
X^h* at TCTLEECB+1 
X^O* at TCTLEECB+1 
X»10» at TCTLEECB+1 
X*80 f at TCTLEECB+2 


| Unless otherwise stated, the bits at TCTLEECB+1, which are left unset 
| by default, have the values given in the action bits table under «TACLE 
I Action and Information Bits” in Chapter 4.2. 


NODE ERROR PROGRAM 


The following error messages, error codes, and action flag settings 
relate to abnormal conditions detected during sessions involving VTAM— 
supported logical units. The code containing the particular error 
condition detected is passed to DFHZNAC in a one—byte field of the 
TWAEC• DFHZNAC then passes control to the appropriate node error 
program for resolution of the error. 

The action flags set are described in full detail in "Logical Unit 
I/O Error Handling (DFHZNAC/DFHZNEP)" in Chapter 5.2 of this manual. 

| The following table provides a quick cross-reference chart for 
I finding the appropriate message number (and associated error condition) 
j for each error code detected by DFHZNAC. 
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r~ 

Error 

Code 

Message 

Number 

1 

1 

Error 

Code 

i 

i 

Message 

Number 

1 

Error 

Code 

i 

i 

Message 

Number 

I 

1 

Error 

Code 

1 

1 

Message 

Number 

T 


x'*10* 

DFH2405 

1 

1 

X • 5A • 

i 

i 

DFB3421 

1 

1 

X* 93 

i 

i 

DFB2455 

1 

1 

X *D1 * 

1 

1 

DFH2410 



X* 11 

DFH2403 

1 

X * 5B * 

i 

DFH3422 

1 

X*94* 

i 

DFH2426 

1 

X *D2 * 

1 

See Note 



X* 13 

DPH2416 

1 

X *5C * 

i 

DFB3424 

i 

X *95 * 

i 

DFB2445 

1 

X *D4 • 

1 

DFB2453 



X • 14 • 

DFH2404 

1 

X'5B* 

i 

DFB3454 

1 

X ■ 96 * 

i 

DFH2436 

1 

X *D5 * 

1 

DPH2452 



X • 15 * 

DFH2407 

1 

X*5F* 

i 

DFH3455 

1 

X* 98 * 

i 

DFH2439 

1 

X*D6 • 

1 

DFH2441 



X' 18* 

DFH2404 

1 

x*6G* 

i 

DFB2421 

1 

X *99 • 

i 

DFH2459 

1 

X*D7* 

1 

DFH2440 



X • 19 * 

DPH2406 

1 

X *63 * 

i 

DFH3441 

1 

X *9B * 

i 

DPH2486 

1 

X *D8 • 

i 

DFB2457 



X 1 1A • 

DFH2408 

1 

X *64 * 

i 

DFH3443 

1 

X* 9C* 

i 

DFH2487 

1 

X*D9* 

1 

DFH2469 



X 1 ID 1 

DFH2417 

1 

X • 65 1 

i 

DFH2448 

1 

X'9D* 

i 

DFH3465 

1 

X»DA* 

1 

DPH2470 



X* 20* 

DFB2417 

t 

X • 66 f 

i 

DPH3452 

1 

X *A 1 * 

i 

DFH2438 

1 

X *DC * 

1 

DFB2442 



x*40* 

DFH2489 

1 

X *67 * 

i 

DPH3442 

1 

X*A3* 

i 

DFH2444 

1 

X *DD • 

1 

DFH2458 



X *41 • 

DFH2490 

1 

X *69 # 

i 

DFB3466 

1 

X* A5 * 

i 

DFH2447 

1 

X *DE • 

1 

DFB3403 



X ' 42 * | 

DFH2496 

1 

X*73* 

i 

DFH2437 

1 

X *A7* 

i 

DFH2449 

1 

X *E0 * 

1 

DFH2411 



■ I 

/DFB2497 

1 

X *74 • 

i 

DFH2423 

t 

X * A8 • 

i 

DFB2471 

1 

X*E1 • 

1 

DFB2412 



X*43 * | 

DFH2434 

1 

X *75* 

i 

DFH2424 

1 

X 1 A 9 * 

i 

DFB2472 

1 

X*E2 • 

1 

DFB2413 



X * 44 * | 

DFH2456 

1 

X * 78 * 

i 

DFB2430 

1 

X *AA • 

i 

DFH2473 

1 

X • E3 * 

1 

DFB2485 



X * 45 * | 

DFH3400 


X *79 * 

i 

DFB2474 

1 

X *B1 * 

i 

DFB2401 

1 

X*E4 * 

1 

DFH2491 



X*46* | 

DFH3402 

1 

X *80* 

i 

DFH2414 

1 

X*B2 • 

i 

DFB2425 

1 

X *E5' 

1 

DFB2499 



X»4B* 

DFH2498 

1 

X *81 • 

i 

DFB2432 

1 

X *B3 * 

i 

DFH2402 

1 

X *B6 * 

1 

DFH2404 



X '50 • 

DFH3417 

1 

X *82 * 

i 

DFB2419 

1 

X *B5 * 

i 

DFH2420 

1 

X *E7* 

1 

DFB2488 



X*51 * 1 

DFH3418 

1 

X *83* 

i 

DFB2450 

1 

X *BA • 

i 

DFH2433 

1 

X*E8 * 

1 

DFB3416 



X*52' | 

DFH3419 

1 

X *84 * 

i 

DFH2446 

1 

X*BB • 

i 

DFH2418 

1 

X *EA * 

1 

DFH3432 



X *53' 

DFH3420 

1 

X *88 * 

i 

DFH2467 

I 

X *BC * 

i 

DFH3410 

1 

X *EB * 

1 

DFB3428 



X' 54 * | 

DFB3434 

1 

X • 89 * 

i 

DFB2468 

1 

X • C5 * 

i 

DFB2427 

1 

X *EC* 

1 

DFB3429 



X'55* 

DFB3440 

1 

X * 90* 

i 

DFB2422 

1 

X* CB 1 

i 

DFB2431 

1 

X *ED • 

1 

DFB3430 



X*57* 

DFB3464 

1 

X *91 * 

i 

DFH2429 

1 

X *CD * 

i 

DFH2454 

1 

X *BF • 

1 

DFB3431 


L_ 

X • 58 • 

X • 59 ' | 

DFB3433 

DFH2443 

1 

1 

X *92 • 

| DFH2428 
I/DFB2493 

1 

1 

X *D0 * 

i 

i 

DFH2409 

1 

1 


1 

1 


J 


Note: Error code X*D2* (symbolic label TCECRP, condition description 
••node recovery in progress”) has no associated error message. 


Error 

Message 

Error Code 
(Symbolic Label) 

Condition 

Action 

Flaas 

DFH2400 

X*** (TCZSRCAT) 

Error not supported. 

X * 60E00300* 



•. 

An unanticipated error 
code was passed to 
CICS/VS by VTAM. 



* Code is vari¬ 
able; taken from 
TCTEVEC5. 

• 

The SYNAD exit was un¬ 
able to identify the 
error received from 

VTAM. 


DFH2401 

X'Bl* (TCZRPLAC) 

RPL 

active. 

X*60E00300* 



• 

A logic error has 



occurred such that a VTAM 
request is being set up 
using an RPL which 
already has an active 
request. 

• The VTAM CHECK macro in¬ 
struction was not issued 
by the appropriate exit. 
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X*20000000 


| DFH2402 X*B3* (TCZNORPL) 


| DFH2403 X 1 11 • (TCZSRCBF) 


| DFH2404 X•14 1 (TCZLRCER) 


| X • 18 • (TCZLRCNR) 

| X*E6 • (TCZDMLG) 

| DFH2405 X*10* (TCZSRCTU) 


| DFH2406 X • 19 * (TCZSRCTS) 


| DFH2407 X*15 # (TCZSRCPF) 


No RPL available when one 
was expected. 

• The RPL pointer field in 
the TCTTE (TCTERPLA) was 
inadvertently cleared. 

• A logic error has 
occurred within CICS/VS 
which caused the RPL to 
be freed* 

Session bind failure. 

• A session cannot be 
established because no 
physical path can be 
found to the logical 
unit. 

• Logical unit does not 
exist. 

• Logical unit does not 
agree with the BIND 
parameters. Possible 
system generation 
mismatch. For an 
intersystem communication 
session, refer to the 
section on sense codes 
sent by CICS/VS. 

VTAM detected a logic error 
with request. 

• VTAM request was either 
not complete or not 
executable. 

• Conflicting parameters 
in the RPL. 

• LERAD exit entered. 

• Not on known TCTTE. 

Node not activated. 

The node either was not 
activated or was deactivated 
by the network operator. 

Terminate-seIf command 
received. 

The logical unit has 
requested to be disconnected. 

Permanent failure with 
channel or NCP/VS. 

• Either the NCP/VS has 
abnormally terminated or 
was shut down by the 
operator. 


X *48004100 


X *60E00300 


X *60E00300 
X*00000000 
X *00004000 

X•00E04000 

X *60E00100 
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| DFH2408 X* 1A ' (TCZSRCVE) 


A channel failure has 
occurred. 


X '60E04100' 


| DFH2409 

| DFH2410 

| DFH2411 

| DFH2412 

| DFH2413 

| DFH2414 

DFH2415 

| DFB2416 




X *00* (TCZTXCS) 


X *D1 1 (TCZTXCU) 


X*B0* (TCZDMSN) 


X § E1 1 (TCZDMRA) 


X *E2 • (TCZDMCL) 


X^O 1 (TCZSRCSP) 


X 1 13• (TCZSRCVH) 


An error has occurred in 
VTAM processing (apparent 
VTAM error). 

VTAM has encountered an error 
in its own processing of the 
request to or from the 
logical unit. 

VTAM recovered node. 

VTAM has successfully re¬ 
established communications 
with the node. 

CICS/VS will reinitiate a 
session with the node. 

Node unrecoverable. 

VTAM cannot reestablish 
communications with the node. 

Node attempted invalid logon. 
An unknown node has attempted 
a logon. The symbolic node 
name is contained in the 
first 8 bytes of the message. 

Receive—any problem. 

Receive—any initiation 
failed. 

VTAM may be in termination. 

Node CLSDST failed. 

The CLSDST of a node in 
logon exit has failed. 

• VTAM storage problem. 

• Apparent VTAM error. 

Temporary VTAM storage 
problem• 

VTAM has run short of avail¬ 
able working storage. This 
situation should eventually 
terminate. 

Not defining enough VTAM 
buffer storage at VTAM 
generation creates such 
a problem. 

Node out of service. 

The node has been taken out 
of service by CICS/VS 
because of an earlier node 
error condition. 

VTAM is halting. 

The HALT QUICK command 
was entered by the 
network operator while a 
SIML0G0N or OPNDST 
request was in progress. 


X•60E20100■ 


X 9 60E04100• 


X*00000000» 


X^OOOOOOOO* 


X^OOOOOOO 1 


x*oooooooo» 


X *00004000 • 
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| DPH2417 X 1 1D 1 (TCZSRCVI) VTW inactive to TCB. X B 00000000* 

• CICS/VS has failed to 
open its VTAM ACB. 

| X*20 • (TCZVTAMI) • VTAM was halted. X*00000000* 

| DPH2418 X , BB• (TCZSEXUC) Unknown indicator in RPL. X , 60E00300 B 

SESSIONC exit, while vali¬ 
dating the RPL at completion 
for a SESSIONC request, was 
unable to determine which 
SESSIONC indicator was sent. 

• Invalid RPL address. 

• RPL was altered. 

| DFH2419 X*82• (TCZSSXUC) Unknown indicator in RPL. X*60E00300* 

Send-data—flow synchronous 
exit was unable to validate 
the indicator sent. 

• Invalid RPL address. 

• RPL was altered. 

| DPH2420 X *B5 * (TCZSAXUC) Unknown indicator in RPL. X*60E00300* 

Send—data—flow asynchronous 
exit was unable to validate 
the indicator sent. 

• Invalid RPL address. 

• RPL was altered. 

| DFB2421 X*60• (TCZUNCMD) Unsupported indicator X*60E00100* 

received. 

Receive-specific exit or 
receive—any has received an 
indicator it cannot handle. 

• If DFHZNAC finds that Note; 

the message is not an If the indicator 

LU status message, the proves to be LU 
indicator is definitely status, see 
unsupported. system sense 

table below. 

• RPL was altered. 

| DFH2422 X*90* (TCZLGCER) DFHZCP logic error. X*E0E00200* 

OPNDST, SIMLOGON or CLSDST 
has detected one of the 
following: 

• OPNDST —node has 
already been opened. 

• SIMLOGON — node has 
already been logged on. 

• CLSDST — CLSDST—activate— 
request bit is not on. 
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| DFH2423 X'74* (TCZSDSE5) 


Incomplete command reguest. X^OEOOIOO* 
A request to send—data-flow 
synchronous command was made 
with incomplete bit settings. 

• TCTTE has been altered. 

• Requesting module has a 
logic error. 

• TCTTE was queued in¬ 
advertently to send 
synchronous. 

| DFH2424 X^S* (TCZSESE1) Command request invalid. X*20E20100* 

SESSIONC command request 
bits are invalid or incom¬ 
plete. 

• TCTTE has been altered. 

• Command request bits are 
incomplete. 

• Queued inadvertently to 
SESSIONC• 

| DFH2425 X t B2 i (TCZSDAUC) Command request invalid. X i 20E20100* 

Send—data—flow asynchronous 
command request bits are 
invalid or incomplete. 

• TCTTE has been altered. 

• Command request bits are 
incomplete. 

| DFH2426 X i 94 > (TCZRACES) Input status error. X*60E00400* 

The receive—any module 
received data from a node 
in one of the following 
conditions: 

• Node is permanently out 
of service. 

• TCT specifies node as an 
output only device. 

| DFH2427 X^CS* (TCZSRCNA) NCP/VS restarted. X*40000000* 

NCP/VS has been restarted 
after failing while an 
OPNDST was in progress. 

| DFH2428 X*92 B (TCZSDSB6) Send-synchronous request X*20A00000 I 

incomplete. 

A send—synchronous request 
failed to indicate whether 
a command or data was to be 
sent. 

• TCTTE has been altered. 

• Inadvertently queued to 
s en d—sy nchro no us. 
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| DFH2429 


| DFH2430 


DFH2431 

I 

I 

I 

I 

| DFH2432 


DFH2433 


| DF92434 
| DFH2435 


X • 91 1 (TCZRSTLE) 


X*78 • (TCZSDRE2) 


Invalid RTYPE• 

An incorrect RESETSR request 

was made. 

• The requestor failed to 
specify or incorrectly 
specified the RTYPE• 

• TCTTE was inadvertently 
altered. 

Indicator request invalid. 

A send—response request was 

made in error. 

• Request failed to specify 
whether response was to 
be FEE or RRN. 

• TCTTE has been altered. 


X *CB • (TCZSRCTC) 


X *81 • (TCZSSXNR) 


X f BA # (TCZSEXNR) 


X* 43 1 (TCZCPYNS) 
X*96 • (TCZRVSZ1) 


Request to a released node. 

If the ACB is open, this 
is a DFHZCP logic error. 

If the ACB is closed, 

CICS/VS is halting and 
CLOSE ACB has been issued. 

Exception response received. 

A SEND DFSYN exit received 
An exception response. 

An exception response to a 
bid was received, containing 
sense information that does 
not relate to the expected 
READY TO RECEIVE (RTR) sense. 

Exception response received. 
SESSIONC exit received an 
exception response. 

An exception response to a 
SESSIONC command was re¬ 
ceived from the logical 
unit. CICS/VS requires 
a normal response. 

Source not valid for copy. 

RPL missing. 

Receive—specific was acti¬ 
vated without an RPL. 

• CICS/VS error such that 
an RPL is expected to 

be present on entry into 
the receive—specific 
module but has been freed 
or was never allocated. 

• TCTERPLA was altered. 
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X *20600000• 


X^OAOOhOO* 


X * 60E00000• 


X^OOOOOOOO* 

(Information 

only) 


X'OOOOOGOO* 
(Information 
only) 


X *20200000• 
X*20600100* 
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I DFH2436 X*97* (TCZRVSZ3) TIOA missing. X*20600100* 

Receive—specific found the 
original TIOA in an over- 
length data condition 
missing. 

• CICS/VS error such that 
the original TIOA was 
freed. 

• TCTTEDA was altered. 

| DFH2437 X*73* (TCZSDSE4) Read-only node. X*20A00000* 

A DFSYN SEND was scheduled 
for an input-only device. 

• TCTTETS was altered. 

• Task was attached that 
does a SEND. 

| DFH2438 X*A1 • (TCZRVSZ2) Invalid read request. X 1 20600000* 

A read (RECEIVE) request 
was attempted for a receive— 
output only device. 

• Task was attached that 
issued a read. 

• TCTTETS was altered. 

| DFH2439 X*98* (TCZACT01) Invalid resume request. X»40004000* 

Activate scan found a TCTTE 
to resume (but a task was 
not attached). 

• TCTTECA was altered. 

• CICS/VS encountered a 

logic error such that 
the task was detached , 
yet the resume flag was 

left on in the TCTTE. 


DFH2440 

X*D7* 

(TCZSXC1) 

CICS/VS quiesced by node. 

The node has indicated that 
all data flow to it should 
stop. Temporarily cannot 
store any more data. 

X*00000000* 
(Information 
only) 

DFH2441 

X'D6* 

(TCZSXC2) 

CICS/VS released by node. 

The node is now ready or 
capable of receiving data 
from CICS/VS. 

X*00000000* 
(Information 
only) 

DFH2442 

X*DC • 

(TCZPXE1) 

Exception response received 
to a definite response send. 
Response exit received an 
exception response. 

X*00000000* 

(Information 

only) 

DFH2443 

X*59 * 

(TCZROCT) 

Request outstanding. 

X•60E00100 ■ 


• A receive request was 
outstanding on a node 
at system shutdown time. 
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| DFH2444 X’A3 1 (TCZBKTSE) 


| DFH2445 X*95* (TCZSDSE8) 


| DFH2446 X > 84* (TCZSSXIB) 


| DFH2447 X # A5* (TCZMIE) 


| DFH2448 X«65* (TCZINVRR) 


| DFH2449 X*A7* (TCZBOEB) 


| DFH24 50 X # 83 * (TCZSSXAR) 


• The high order bit in 
the NIB address—field was 
turned on by DFHZNAC, 
indicating no further 
communication should be 
attempted with this node. 

CICS/VS bracket state error. X•60E00100 , 
Application program violated 
CICS/VS bracket protocol. 

Application issued a DFHTC 
read after a WRITE LAST. 

Output area exceeded. X"20AOOOOO' 

TIOA length error. 

• Application set up 
TIOATDL incorrectly. 

• Application overran the 
TIOA. 

Invalid response to bid. X , 60E00300 t 

A normal response was re¬ 
ceived to a bid while in 
bracket state. 

The 3601 application 
program is in error. It 
has lost track of the 
bracket status of the node. 

Message exceeds maximum X , 60600400 i 

input. Either receive—any or 
receive-specific received 
more data than the user- 
defined system maximum. 

Hardware problem such that 
the current buffer is con¬ 
tinuously sent without any 
operator intervention. 

Invalid response requested. X , 60600700 l 
Receive-specific, receive— 
any or receive-specific exit 
received data from the logical 
unit without a response requested 
(FME-RRN). RPL altered. 

Bracket error. X*60204500* 

Receive-specific exit or 
receive-any received either 
a begin bracket when already 
in bracket state , or an end 
bracket, or data not marked 
by begin bracket after CICS/VS 
had sent an end bracket. 

Bid issued but ATI canceled. X*00000000* 
The ATI which caused a bid 
to be sent was canceled. 

• The ATI was time- 
initiated dependent. 

• CICS/VS error. 
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X•SOEOOOOO 


| DFH2451 X’CC* (TCZSRCCI) 


| DF32452 X*D5* (TCZCXB2) 


| DFH2453 X»D4» (TCZCXRR) 


| DFH2454 X*CD* (TCZSRCCX) 


Outstanding request when 
clear was issued. 

A request (receive-specif ic) 
was outstanding when clear 
was issued by CICS/VS or 
by VTAM. 

• A clear—unbind was issued 
by VTAM when communica¬ 
tion with the node was 
lost (LOSTERM exit node 
unrecoverable). 

• CICS/VS terminated the 
session (CLSDST)• 

• CICS/VS issued the clear 
in an effort to clean up 
or resynchronize the 
session. 

Invalid indicator received. X , 20E04100 

Session control input exit 

received an indicator from 

the logical unit other than 

request recovery. 

Request recovery received. X’EOOOOOOO 

The logical unit has 
indicated that recovery 
processing is needed. 

Exception in chain. X^OEOOOOO 

Exception response returned 
on a POST=RESP chained data 
send. 

• Error within CICS/VS. 

CICS/VS does not send 
chained data with 
POST=RESP. 

• VTAM error. 


| DFH2455 X # 93’ (TCZRACET) 


| DFH2456 X’44» (TCZSRCDE) 

I 

I 


Continue-any mode with task X # 60E20500 
attached. 

The node was in continue-any 
mode, yet a task was still 
present. 

Task presently on the node 
should have been abnormally 
terminated, but was not. 

The node was closed and 
simulated logged on, which 
put it into continue-any mode. 

Received exception response X a 60E04100 
to a command. 

Logical unit sent an exception 
response to a command. 

CICS/VS does not support an 
exception response from the 
logical unit to a command 
other than bid. 
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I DFH2457 X'DS 1 (TCZRNCH) 


| DFH2458 X*DD # (TCZPXE2) 

| DFH2459 X'99* (TCZSDSE7) 


| DFH2467 (TCZLEXCI) 


| DFH2468 X i 89 > (TCZLEXUS) 


| DFH2469 X f D9 f (TCZTX43) 


| DFH2470 X # DA* (TCZSXC3) 


Multiple catastrophic errors X^OEOOIOO 1 
encountered. 

More than one consecutive 
error has been encountered 
by a node without the first 
error being processed. 

That is, while DFHZNAC is 
processing the first error 
encountered with a node, 
another synchronous error 
occurs which overlays the 
previous error code. 

Received exception response X l 00000000* 

to exception response SEND. (Information 

only) 


No TIOA available for SEND. X*20A00000 1 
TIOA for SEND was not avail¬ 
able. 

TCTTEDA was not loaded prior 
to issuing the DFHTC 
TYPE=WRITB macro or was in¬ 
advertently cleared. 

Invalid CID detected. X , 60E00200* 

A VTAM request was made 
with an invalid CID. 

TCTECID was altered. 

Unknown symbolic name. X^OEOOIOO* 

A request was made to VTAM 
with an invalid symbolic 
node name. 

• Symbolic name altered 
in the NIB. 

• VTAM definition and TCT 
entries do not agree. 


Exception response received. X f 60E00000* 
An exception condition 
exists for an inbound 
message. 

Invalid sequence numbers. 


Request shutdown received X , 00E00100 i 
while task active. 

• The controller application 
program sent RSHUTD 
(Request Shutdown) on 
behalf of a node while a 
task was still attached. 


• During VTAM shutdown, a 

shutdown complete indicator 
was received from the 
controller application 
program on behalf of a 
node while a task was 
still attached. 
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• During VTAM shutdown, a 
task was still attached to 
a VTAM 3270 (which cannot 
send request shutdown or 
shutdown complete)• 

| DFH2471 X • A8 # (TCZFMHLE) FMH length error. X *70600500 1 

The function management 
header length was greater 
than that of the data 
received from the logical 
unit. 

• The logical unit built 
the FMH incorrectly. 

• Transmission error. 

| DFH2472 X«A9* (TCZRACRF) Unable to retrieve over- X‘00200000 1 

length data. 

The receive request for the 
remainder of data that 
in excess of the receive any 
input area, was not accepted 
by VTAM. 

| DFH2473 X*AA # (TCZSDSE9) Outbound chaining not X^OAOOOOO 1 

supported. 

The CICS/VS application 
program has attempted to 
send more data to the 
logical unit than its 
generated maximum permitted 
length, and the logical unit 
does not support outbound 
chaining. 

| DFH2474 X»79 # (TCZATINS) ATI not supported. X^OOOOOGO 1 

A task was automatically 
initiated for a logical unit 
which was defined at table 
generation time as not 
supporting ATI. 

| DFH2485 X«E3» (TCZCNCL) Cancel received in ”CS» X•20E00000 , 

mode. A CANCEL indicator was 
received while a task was 
active. 

| DFH2486 X*9B» (TCZEACNL) Cancel received in «CA« X•20000000* 

mode. A CANCEL indicator was 
received while no task was 
active. 

| DFH2487 X»9C* (TCZOCNL) Outbound chain canceled. X^OBOOOOO* 

I An outbound chain was not 

I completed at task detach 

I time. 

| DFH2488 X*E7» (TCZIPGC) Inbound chain purged. X*00000000• 

Unprocessed inbound data 
remained at task detach time. 
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I DPH2489 x § 40* (TCZINCPY) 3270 — Invalid copy request* X f 2OAO0OGO • 

The terminal control table 
terminal entry (TCTTE) of the 
"from” device did not specify 
the COPY feature, or the "from 11 
device is not defined in the 
TCT, or is not a 3270, or is not 
connected to CICS/VS via VTAH. 

| DFH2490 X* 41 • (TCZTOLRQ) Request for TOLTEP. On a X i 60E20100 l 

request for TOLTEP, a receive 
request completes in error. 

| DFH2491 X*E4 1 (TCZSXC4) Segmenting error. X^OEOOIOO 1 

A segmenting error was 
detected by the LOSTERM exit. 

| DFH2497 X‘42 1 (TCZUNPRT) Unavailable printer. X*00000000* 

A print function was requested 
on a 3270 display and neither 
the ,i PRINTTO M nor the "ALTPRT" 
printer was available to 
receive the information. 

| DFH2498 X # 4B* (TCZICPUT) Interval control PUT to X•00000000 , 

printer failed. 

| DFH2499 (TCZRUER) RU exceeds RUSIZE at maximum X , 20600000 t 

chain size. If chain 
assembly has been specified 
in the TCTTE, the reguest unit 
(RU) read in is bigger than 
the remaining space in the 
TIOA and bigger than the 
maximum RUSIZE. 

| DFH3400 X^S* (TCZCHMX) Chain exceeds maximum chain X , 20600400 l 

size. If chain assembly has 
been specified in the TCTTE, 
the chain being assembled does 
not fit into the TIOA for a 
maximum chain. The remaining 
space in the TIOA is smaller 
than the maximum RUSIZE. 

| DFH3402 X'46 1 (TCZOCIR) Invalid read. X I 20E00000 # 

A DFHTC TYPE=READ request is 
being processed although the 
previously issued DFHTC 
TYPE=WRITE request did not 
complete a chain. 

| DFH3403 X*DE• (TCZFSHD) Failed to get in send mode. X*2GE00000 t 

CICS/VS could not break the 
inbound data flow in order 
to send a message to the 
logical unit. 

| DFH3410 X*BC• (TCZINIIR) Invalid input when LUSTATUS X^OEOOOOO 1 

expected. Input other than 
LU status message received 
after system sense 
X*0802 i (intervention required) 
or X , 0807 t (resource 
temporarily unavailable). 
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I DFH3416 

I 

| DFH3417 

| DFH3418 

| DFH3419 

| DFH3420 

| DFH3421 

| DFH3422 

| DFH3424 
| DFH3428 

I DFH3429 

| DFH3430 

| DFH3431 

| DFH3432 

| DFH3433 


X*E8* (TCZDMSLE) 
X*50* (TCZSDRB3) 

X*51 * (TCZBDPRI) 

X*52* (TCZBDUAC) 

X*53* (TCZBDTOS) 

X *5 A • (TCZSBIRV) 

X *5B * (TCZNSPO 1) 

X*5C* (TCZNSP02) 
X *EB • (TCZSTRMH) 

X *EC * (TCZSTRMM) 

X*ED* (TCZSTON) 

X *EF * (TCZSTIN) 

X*EA • (TCZSTLER) 

X • 58 • (TCZERMGR ) 


Negative response to BIND X*60000000* 

failed. 


A sync point request has X*00E04000* 

been ignored. Neither 
commit nor abort has been 
issued. 


The name in the bind area X*20E00100* 
matches a primary TCTTE. 

The TCTTE generation should 
specify a secondary. 


The requesting system has X*68000000* 

passed unacceptable bind 

parameters. 

LOGON was requested for a X*00001000* 
terminal that had not been 
placed in service. 

A shutdown request was X*00001000* 

received for the system, and 
an orderly termination 
procedure was begun. 

An error occurred while X*60E04100* 

trying to establish an ISC 
session. The request was 
terminated before the session 
was established. 


Session failure. Session X*60E00100* 

terminated immediately. 

CICS/VS expected a resynch— X*20000000* 

ronization process to occur 

during session initiation, 

but the LU did not 

resynchronize. 

Resynchronization error. X*60000000* 

CICS/VS did not resynchronize 
and the other LU was expecting 
resynchronization. 


Resynchronization error. X*60000000 • 

Outbound flow sequence numbers 
do not agree with those of the 
other LU. 


Resynchronization error. X*60000000• 

Flow sequence numbers do not 

agree. 


Resynchronization error. X*60000000 • 

Unexpected code received in 
response to STSN. 


Error message received. X*00000000* 

One side of the intersystem 

link sent a negative response 

or LUSTAT with code X*0846*, 

implying that an error message 

is the next message to follow. 
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| DFH3434 X*54* (TCZUNBIS) 


DFH3437 


| DFH3440 

X* 55* 

(TCZEMWBK) 

| DFH3441 

X *63 • 

(TCZVTAMO) 

| DFH3442 

X*67* 

(TCZVTAMK) 

| DFH3443 

X *64 • 

(TCZVTAMA) 

| DFH3452 

X 1 66 • 

(TCZSIGR) 


DFH3454 

X*5E* 

(TCZBRUAC) 

DFH3455 

X»5F* 

(TCZBDSQP) 

DFH3464 

X *57 * 

(TCZRELIS) 

DFH3465 

X*9D* 

(TCZRSPER) 

DFH3466 

X *69 • 

(TCZSEXOS) 


The sense code obtained from 
within the message is used to 
drive any appropriate actions. 

UNBIND received while X*60E00100* 

session active. 

One side of the intersystem 
link (the secondary LO) 
received an UNBIND command 
without the normal termination 
protocol being observed. An 
abnormal termination of the 
session was performed, probably 
caused because the other side 
of the link abnormally 
terminated. 

After an error has been 
processed by DFHZNAC, certain 
actions may be taken to "correct” 
the error. This message lists 
the actions taken. 

Unable to send error message. X*00000000 

Orderly termination of VTAtt 1*00000000 
sessions requested — either 
by the CICS/VS master terminal 
command or by the VTAM network 
closing down. 

Immediate termination of X*00000000 

VTAM sessions requested. 

VTAM has been canceled. X*00000000 

Signal received — code xxxx 1*00000000 

xxxx. SIGNAL command received 
from an LUTYPE4 logical unit. 

Signal code is available in 
TCTESIDI• 

Negotiable BIND response X*68004100 

session parameter unacceptable. 

Bad session qualifier in X*68004100 

BIND response. 

Release command issued by X*00000100 

Master Terminal operator. 

Unexpected response received. X*E0E00200 

Terminal out of service after X*00001200 
SDT sent. 
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SYSTEM SENSE CODES RECEIVED 


The following list indicates the actions taken by DFHZNAC upon receipt 
of inbound system sense codes. If no system sense code is received, no 
action is taken by DFHZNAC. However, the user sense code is available 
for analysis by the user # s node error program. Refer to Figure 5.2 for 
details of the action flags set by DFHZNAC• 

System 

Sense Action Error 

Received Flags Message Condition 


| X*0801• 

| X *0802 1 

| X *0806• 
l x'osc^* 

| X•OBOB* 


| X •080E • 

| X 1 080F 1 
| X *0811 • 


I x'os^* 


| X•081B 1 


X * 20E00000• DFH2476 

X*00000000» DFH2461 

X^OOOOOOOO* DFH3426 
X'OOOOOOOO 1 DFH3411 

X •6QE20100• DFH2462 

X»00000200 • DFH3448 

X•00E00000 i DFH2462/DFH3436 

X *OOEOOOOO• DFH2464 

X'SOOOOOOO* DFH2465 


X•60000000* DFH2483 

X •60E00000* 

X 1 60E00100• 


A component of the logical unit 
is no longer available. 

Probable cause is a device 
error or loss of contact. 

Intervention required. 

Forms are required at an output 
device. See note, below. 

TCTTEs do not match. 

Resource temporarily not 
available. See note, below. 

Bracket error. 

Task initiation attempted by 
both the logical unit and 
CICS/VS. 

Security identification 
error. LU not authorized. 

End user not authorized. 

Terminate chain. 

Chain rejected by the logical 
unit when purging incoming 
messages following error 
recovery. 

Insufficient resources. 

• Diskette data set is 
full. 

• Data segment not large 
enough to handle data 
set. 

• Component temporarily not 
available. 

Receiver in transmit mode. 
Action flag X f 600000• is set 
for negative response received 
to a send which requested 
a definite response. 

X*60E000• is set for negative 
response to an exception 
response send, or if end 
bracket has been sent. 
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I x^eic* 


| X»0824 1 


| X , 0825* 

| X 1 0827 1 


| X•0829* 


| X•082A* 
| X*082B» 


| X*082D» 

| X 1 082E 1 

| X 1 082F 1 

| X•0831 1 
| X*0833 1 


X•60EQ0000• DPH2466 

X■60E00100• 


X'20EOOOOO» DFH2475 

X•60E00000 * DPH2484 

X *20000000 1 DFH2480 


X # E0600100 # DFH3407 

x^oosooooo 1 - 

X^OSSOOOO 1 DFH3408 

X'OOOOOOOO 1 DFH3413 

X*00000000» DPH3412 

X•60E00000 1 DFR3414/DFH3436 

X«00000000» DFH3438 


X•60E001• forces close 
destination to be issued. 

This action is set if CICS/VS 
is not in send mode. 

Function not executable. 

The logical unit cannot 
deliver the message to the 
node because of a data check 
condition or because the node 
is not available. 

X 1 60E001* forces close 
destination to be issued. 

This action is set if the 
response was received for an 
SNA command sent by CICS/VS. 

The logical unit has aborted 
all current processing with one 
of its components because 
failure or loss of contact 
with that unit. 

Component not available. 

An application request could 
not be satisfied. 

The logical unit has requested 
retransmission of data from 
the host. This applies only 
to those transactions with 
message integrity or to requests 
using definite response 
protocol• 

Head command not marked 
change direction. 

The request requires the 
change direction indicator 
to be set. This was not done. 

Presentation space error. 

Presentation space integrity 
lost. Error on display or in 
buffer due to hardware error: 
for example, regen buffer 
parity error. 

Logical unit busy — unable 
to process request. See note, 
below. 

Intervention required on 
secondary resource; resource 
is currently not available. 

See note, below. 

Request not executable. 

Secondary resource 
unavailable• 

Device powered off. 


X*00000000* DFH3427 Error in bind (format). 
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| X*0847* 


X*00000000 1 DFH3439 


Negative response received 
to SDT. 


| X *084A• X*00000000* 


| X•0840* 

I x* 0860 * 

| X *0863• 
| X *0864 1 

I x*0865* 

| X•0866* 

| X*0868* 

| X *0869 • 


X*00000000* DFH3459 

X*00000000* DFH3460 

X*20200000• DFH2475 

X *20EOOOOO • DFH2465 

X *20EOOOOO• DFH2475 

X*00000000* DFH3456 

X*00000000* DFH3457 


| X•08FF* X *60EOOOOO* DFH3447 

| X*1001* X•60E00000• DFH2481 

or 

X • 1002 • 


| X•1003• X•60E00000* DFH2479 


Presentation error on read. 
Display buffer alteration, due 
to operator intervention, 
detected on a HEAD command to 
a compatibility mode logical 
unit. Note that X*082A* received 
in response to a send request 
is not treated as an error 
condition. 

Permanent insufficient resource. 
The PS buffer addressed by the 
LOAD PS statement is not 
available at this terminal. 

Negative response from 32MI 
terminal. 

Requested programmed symbols 
set has not been loaded. 

The logical unit has aborted 
all processing connected 
with one of its components 
and no retry is possible. 

The subsystem controller 
application program has 
insufficient resources to 
handle the request. 

The logical unit has aborted 
all processing connected 
with one of its components 
and retry is possible. 

An outboard format is 
referenced, but no outboard 
formats are loaded on this 
logical unit. 

The requested outboard 
format is not loaded on this 
logical unit. 

Request reject error. 

The RU (reguest—response 
unit) transmitted to the 
logical unit was either 
untranslatable or its length 
was too long or short. 

The RU (request—response unit) 
passed to the logical unit 
is not a supported function. 
Either a transmission error 
or data overlaying the RU 
caused the problem, or SCS 
parameters are not supported. 
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| X 1 1005* 


| X * 1008 1 


1 X*10xx* 
| X *2003■ 

| X *20xx * 
| X*400B* 


| X*4 0xx* 

| X*8000* 

| X # 80xx• 

| Other 
codes 


X•bOEOOOOO• DFH3406 


X•60B00000• DFH2478 

X > 00C00000 , 

X •00000000* 


X *60E00Q00 • DFH3446 

X•60E20100* DFH3405 


X•600B0100* DFH3445 

X*A0200000* DFH2477 


X *60800100 1 DFH3453 

X•60E04100 1 DFH3435 

X•60E04100* DFH3435 

X * 60E00100 * DFB2460 


Parameter error # 

The RU received by the logical 
unit contains a control function 
with invalid parameters. 

Invalid FMH . 

Invalid length/type field 
in TIOA received with FMH, or 
invalid FMH parameters. 

If the request was not made 
by means of the batch data 
interchange program, the action 
flags are set to X*60EOOO*. 

If DFHDIP was used, an action 
flag of X*000000* is set if 
DFHDIP determines that it can 
handle the situation, and 
X*00c000 1 is set if the error 
occurs on an exception response 
made by DFHDIP. In both cases, 
control returns to DFHDIP, 
which in turn passes control to 
the application program with an 
appropriate DFHDIP return code. 
Further information on DFHDIP 
can be found in the appropriate 
CICS/VS Application 
Programmer*s Reference 
Manual. 

Request error. 

Catastrophic bracket error. 
CICS/VS attempt to start a 
bracket conflicted with the 
receiver*s understanding of 
the current bracket state. 

State error. 

The logical unit does not 
support chained data from 
the host. Consideration 
must be given to the amount 
of data to be transmitted 
to the logical unit. 

RH usage error. 

Path error• 

Path error. 

Sense received not supported. 
Sense codes not supported 
by CICS/VS were received 
from the logical unit. 

If zero system sense provided, 
the user sense may indicate 
the source of the error. 

Note that codes X*0813* and 
X*0814* are handled entirely 
by CICS/VS without DFHZNEP 
intervention. 
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The following codes may arrive as LUSTATUS command codes only. In 
addition, some codes of the X*08xy* type may also be sent via LUSTATUS 
and are handled in the same way as when sent via negative response 
system sense: 


System 

Sense 

Received 


Action 

Flags 


Error 

Message 


Condition 


| X*0001* X•40000000• DFH3401 


Component now available. 


| X 1 0002* X•60000000* DFH3415 


No data available. Logical 
unit has no data to send. 


| X *0003 * X*00000000* DFH3449 

| X *0004 * X*00000000* DFH3450 


Leaving unattended mode. 
Entering unattended mode. 


| X*0007* 

I 


X*00000000* DFH3451 

or 

X•00000800• 


Currently no data to send. 
Action flag X*000000* set if 
a task is attached or if 
outstanding operations are to 
complete; otherwise, X*000008* 
will be set. 


Note; For logical unit types 1, 2, 3, and 4 (that is, other than 3600, 
3650, or 3790 inquiry logical units) CICS/VS will not retry the failing 
request until it receives an LUSTATUS command with the system sense code 
of X*0001 *• If the LUSTATOS system sense received is not X*0001*, the 
resultant error action code will apply to the original request. 


If sense/status information is received from a 3270, one of the 
following three messages will be issued in addition to DFH2442, DFH2458, 
or DFH2469. 


3270 Action Error 

Sense/Status Flags Message Condition 


| X*0210• X*60000000* DFH2492 Intervention required on 3270 

printer. 

• Printer out of paper, cover 
open, or offline. 

• Transaction request to 
start printer, but no 
printer present. 

• Printer adapter feature 
not present. 

| X*0010* X*60000000• DFH2493 Intervention required on a 

3270 device. 


| xxxx X*60EOOOOO* DF82494 


Error status xxxx 
received from a 3270 device. 
The message contains 
the sense/status received. 


Detailed information on 3270 sense/status is given in the 3270 
Information Display System; Component Description manual. 
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Appendix F. Sample TCAM SNA Message Control 
Programs 


The following Appendix contains two sample TCAM SNA message control 
programs (MCPs). The MCPs given have the following functions: 

• Sample 1: — control of the SNA sessions is independent of the 

CICS/VS application programs 

• Sample 2: — controls the SNA sessions according to the 

requirements of the CICS/VS application programs 

Further information on TCAM devices in a TCAM SNA environment and on 
MCPs for TCAM SNA devices is given in Chapter 5.3 under H CICS/OS/VS with 
TCAM SNA'*. 


SAMPLE 1: "DFHSPTM1 - SAMPLE TCAM MCP FOR TCAM DIRECT • 


*********************************************************************** 

* 

* 

* 

* NAME - CICS SAMPLE TCAM MESSAGE CONTROL PROGRAM AND MESSAGE HANDLERS 

* (INDEPENDENT CONTROL) 

* 

* PURPOSE - THE PURPOSE OF THIS SAMPLE IS TO DEMONSTRATE TO THE CICS 

* USER WHAT IS REQUIRED FOR THE CREATION OF A SIMPLE CICS SNA 

* NETWORK USING TCAM. THE SAMPLE DEMONSTRATES HALF-DUPLEX 

* FLIP/FLOP MODE WITH BRACKETS. 

* 

* 

♦ FUNCTIONS - THE FUNCTIONS ARE AS FOLLOWS: 

* 

* INTRODUCTION - DEFINE THE OVERALL SYSTEM PARAMETERS, INITIALIZE 

* THE SYSTEM, AND START MESSAGE TRAFFIC. 

* 

* DEFINITION - DESCRIBE THE SPECIFICS OF THE NETWORK, THE MESSAGE 

* QUEUES, AND THE NECESSARY CONTROL BLOCKS. 

* 

* DEVICE MESSAGE HANDLER - INSERT THE COMMUNICATIONS CONTROL BYTES 

* AND ROUTE THE MESSAGE FOR INPUT, REMOVE THE CCB AND ROUTE 

* THE MESSAGE TO ITS PROPER DESTINATION ON OUTPUT. THE DMH IS 

* NAMED ■CICS 1 SO THAT AN LU CAN LOGON TO ■CICS i . 

* THIS MH SUPPORTS LU TYPEO, TYPE1, AND TYPE2. THE SUPPORT IS 

* DESIGNED TO ALLOW THE DEVICE MH TO CONTROL THE LU. 

* LU TYPE 1 SUPPORT: 

* THE LU MUST BE BOUND TO ALLOW IT TO SEND END BRACKET. THE HOST 

* WILL BEGIN AND END A BRACKET ON EVERY CHAIN EXCEPT WHEN A 

* DATASET IS BEING SENT. IN THIS CASE THE BRACKET WILL NOT BE 

* ENDED UNTIL THE END OF DATASET. OTHER METHODS OF OPERATION 

* ARE POSSIBLE BY USING DIFFERENT MH OPTIONS. THE LU TYPE 1 

* BATCH SUPPORT ASSUMES A SINGLE TRANSACTION WILL HANDLE THE 

* BATCH INPUT. THE MH WILL EDIT THE TRANSACTION NAME INTO 

* THE FIRST CHAIN OF THE DATASET. THEREFORE IT IS NOT NECESSARY 

* TO PLACE A TRANSACTION NAME INTO THE DATASET. 

* LU TYPE 2 SUPPORT: 

* LU TYPE 2 IS THE 3270 DATA STREAM EMULATOR. 

* THE SUPPORT IS DESIGNED TO ALLOW THE TRANSACTION TO OPERATE 

* INDEPENDENTLY FROM THE OUTBOARD LU. THEREFORE THE KEYBOARD 

* IS UNLOCKED AFTER EVERY INPUT. SINCE AN LU TYPE 2 CANNOT BE 
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* BOUND TO SEND END BRACKET A MSGGEN IS USED TO UNLOCK IT. 

* ALSO THE HOST WILL BEGIN AND END A BRACKET ON EVERY CHAIN. 

* THIS WILL CAUSE THE KEYBOARD TO UNLOCK AFTER EVERY OUTPUT 

* MESSAGE. IF A DIFFERENT METHOD OF OPERATION IS DESIRED 

* LOGIC COULD BE ADDED TO ONLY END THE BRACKET WHEN THE KEYBOARD 

* UNLOCK SEQUENCE IS SENT. 

* 

♦ 

♦ APPLICATION MESSAGE HANDLER - ROUTE MESSAGES FROM THE INPUT QUEUE 

♦ TO CICS AND FROM CICS TO THE APPROPRIATE OUTPUT QUEUE. 

♦ 

* 

* THE SSCP MESSAGE HANDLER - UTILIZES THE IBM—SUPPLIED MH TO 

* PERFORM THE NECESSARY ROOTING AND ANALYSIS FUNCTIONS. COMPLEX 

* USER SYSTEMS MAY REQUIRE THIS TO BE MODIFIED BY THE USER. 

* 

* 

* NOTES - 

* 

* CONVENTIONS 

♦ 

♦ REGISTER 

♦ 

* REGISTER 

♦ 

♦ REGISTER 

* 

♦ REGISTER 

♦ 

* REGISTER 

* 

* DEFAULTS - 

* 

♦ MACRO DEFAULTS ARE USED WHEREVER REASONABLE 

* 

♦ 

* EXITS - 

* 

* NORMAL - 

* 

♦ RETURN TO THE 0S/VS SUPERVISOR WHEN SHUTDOWN IS COMPLETE 

sit 

♦ ERROR - 

♦ 

* X § FFF 1 - ABEND ON INTRO FAILURE 

sit 

* X•FFE• - ABEND ON MESSAGE QUEUE DCB OPEN FAILURE 

s|c 

* X *FFD• - ABEND ON 3705 DCB OPEN FAILURE 

* 

* 

* 

sit 


CICSTCAM 

RDCB 

CSECT 

EQU 

2 

DCB REGISTER 

LINKRBG 

EQU 

3 

INTERNAL LINKAGE REGISTER 

RWORK 

EQU 

4 

INTERNAL WORK REGISTER 

RSCANSVE 

EQU 

5 

SAVED SCAN POINTER REGISTER 

RSCAN 

EQU 

6 

SCAN POINTER REGISTER 

RRETURN 

EQU 

15 


OPEN 

EQU 

X 1 10 1 

DCB OPEN FLAG 

DCBOFLGS 

EQU 

X*30 # 

OPEN FLAGS OFFSETF 

WORD 

EQU 

4 

OFFSET 


SPACE 

2 



2 IS USED AS THE DCB REGISTER 

3 USED AS INTERNAL LINKAGE REGISTER 

4 USED AS INTERNAL WORK REGISTER 

5 USED AS INTERNAL WORK REGISTER 

6 USED AS THE SCAN POINTER REGISTER 
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* 

CCB BYTE 0 



SPACE 



CCBFMH 

BQU 

X'01' 

FORMATTED HEADER 

CCBDISC 

EQU 

X *08 * 

DISCONNECT 


SPACE 

2 


* 

CCB BYTE 1 



SPACE 



CCBEB 

EQU 

X'OI* 

WRITE LAST SPECIFIED 

CCBCD 

EQU 

X^O 1 

WRITE WITH READ SPECIFIED 


SPACE 

2 


FMHLEN 

EQU 

0 

BYTE 0 OF FMH 

FMHTYPE 

EQU 

1 

BYTE 1 OF FMH 

FMHSEL 

EQU 

2 

BYTE 2 OF FMH 

FMHSTCK 

EQU 

3 

BYTE 3 OF FMH 

FMHPROP 

EQU 

4 

BYTE 4 OF FMH 

FMHTYP1 

EQU 

X«01 * 

TYPE 1 FMH 

FMHBDS 

EQU 

X *40 • 

BEGIN DATASET FMH 

FMHEDS 

EQU 

X^O* 

END DATASET FMH 

PRFSTAT1 

EQU 

X 1 1 4 • 

STATUS BYTE OFFSET 

PRFNLSTN 

EQU 

X *02 • 

NOT LAST INDICATOR 

ZERO 

EQU 

0 


ONE 

EQU 

1 


TWO 

EQU 

2 


FOUR 

EQU 

4 


* * * * * * ******* 4c ***** * * ** * *** * * *********** 4C ******** * ****** * 4c# * **** * *** * 

* 

SNACTL OPTION FIELD USAGE 


SNARCD 

EQU 

X'OI* 

REMEMBER TO SET CD 

SNASCD 

EQU 

X *02 * 

CD HAS BEEN SENT TCAM CANNOT 

* 



SEND ANY DATA 

SNASDS 

EQU 

X *04 * 

SEND DATASET STATE 

SNARDS 

EQU 

X *08 1 

RECEIVE DATASET STATE 

SNALUT2 

EQU 

X^O 1 

TYPE 2 LU THE 3270 DSE 

********************************************************************* 


EJECT 




INTRO 

PBOGID=CICSTCAM, 




UNITSZ=160, 

BUFFER UNIT SIZE 



LNOHITS=100, 

SEE TCAM SYSTEM PGMER 1 S GUIDE 



BRACKET=YES, 

INCLUDE BRACKET STATE MANAGER 



BTRACE=500, 

PIU TRACE ENTRIES 



CIB=5, 

MAX 5 ACTIVE OPERATOR COMMANDS 



COMWRTE=YES, 

INCLUDE SERVICE AID WRITER 



CONTROL=OPCTL, 

ALLOW COMMANDS FROM OTHERS 



CPB=20, 

ACTIVE DISK CHANNEL PROGRAMS 



DISK=YES, 

DISK MESSAGE QUEUES 



DLQ=0, 

NO DEAD LETTER QUEUE 



DTRACE=500, 

DISPATCHER TRACE ENTRIES 



FEATURE= (NODIAL,MO2741 

,,,ONLY3705,ONLYSNA) , 



MSIJHITS=100, 

BUFFER UNITS FOR CORE QUEUE 



HAXSUBA=3, 

OBTAIN FROM NCP GENERATION 



PLCBNO=20, 

PSEUDO LCBS NEEDED FOR I/O 



PBIHARY=SYSCOM, 

OPERATOR CONTROL CONSOLE 



SIBCNT=25, 

MAXIMUM SNA SESSIONS PERMITTED 



SOBAREA=1 

OBTAIN FROM NCP GENERATION 


LTR 

REETURN,BRETURN 

WAS INTRO SUCCESSFUL 


BZ 

OKINTRO 

IF SO, CARRY ON 


STH 

RRETURN,DEBUG 

MAKE RETURN CODE VISIBLE 


ABEND 

4095,DUMP 

OTHERWISE, PUNT WITH X , FFF* 

OKINTRO 

OPEN 

(USGQUEUE, (INOUT)) 

OPEN MESSAGE QUEUES DATA SET 


LA 

RDCB,HSGQUEUE 

POINT TO DCB 


TM 

DCBOFLGS (RDCB),OPEN 

WAS OPEN SUCCESSFUL 


BO 

OKOPENQS 

IF SO, CARRY ON 


ABEND 

4094,DUMP 

OTHERWISE, PUNT WITH X^FE 1 

OKOPENQS 

OPEN 

(NCP1DCB, (INOUT)) 

OPEN 3705 FOR COMMUNICATIONS 


LA 

RDCB,NCP1DCB 

POINT TO 3705 DCB 


TM 

DCBOFLGS(RDCB),OPEN 

WAS OPEN SUCCESSFUL 
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BO OKOPEN05 
ABEND 4093,DUMP 
OKOPEN05 READY 

CLOSE (NCP1DCB,,MSGQUEUE,) 

RETURN (14,12) 

EJECT 

*********************************************************************** 

* 

* DEFINE THE CONFIGURATION OF THE NETWORK - PHYSICAL AND LOGICAL 

* 

*********************************************************************** 

SPACE 2 


IF SO, CARRY ON 
OTHERWISE, PUNT WITH X l FFD l 
LET TCAM START TRAFFIC 

RELINQUISH CONTROL 


DS 

DC 

DEBUG DS 
DC 

MSGQUEUE DCB 


NCP1DCB DCB 


CICSPCB PCB 


RETURN CODE = • 


SNACTL 

NCP1 

GRP1 


LI 


PU1 

P1T1 

P1T2 

P1T3 

P1T4 


PU2 

P2T1 

P2T2 

L2 

PU3 

P3T1 

PU4 

P4T1 

CLNE 


TLNE 

SSCP 


OD 

C» 

H 

C 1 • 

DSORG=TQ, 

DDNAME=MSGQUEUE, 

MACRF= (G,P) , 

OPTCD=R 
DSORG=TR, 

DDNAME=DDNCP1, 

MACRF= (G , P) 
MH=AMH,BUFSIZE=2000 
TTABLE LAST=SSCP 
OPTION XL 1 

TERMINAL DCB=NC?1DCB, 

TERM=LNCP,IPLTXID=NCP1TXT 


TRIGGER FOR DUMP SCANNING 
TO CONTAIN INTRO RETURN CODE 
SPACING AROUND MESSAGE 
MESSAGE QUEUE DATA SET 


REUSABLE DISK QUEUES 

3705 COMMUNICATIONS CONTROLLER 


APPLICATION PROGRAM MH 
TERMINAL TABLE START AND END 

POINT TO PROPER 3705 


X 

X 

X 

X 

X 


GROUP MH=CICS,BUFSIZE=238, 
OPACING=2 

TERMINA L TERM =LINE, 

GROUP=GRP1, 

RLN=1, 

ACTIVE=YES 

TERMINAL TERM=PUNT 


X 

X 

X 


X 


X 


POINT TO DEVICE MESSAGE HANDLER! 
DEFINE HOST PACING 
DEFINE FIRST SDLC LINE 
POINT TO PROPER GROUP 
FIRST LINE 

ACTIVATE LINE AUTOMATICALLY 
3790 PHYSICAL UNIT - 

TERMINAL GROUP=GRP1,QBY=T,QU£UES=MR,RLN=1,TERM=LUNT, 

TCMSESN=LUINIT,OPDATA=(80) 

TERMINAL GROUP=GRP1,QBY=T,QUEUES=MR,RLN=1,TERM=LUNT, 
TCMSESN=LUINIT,OPDATA=(80) 

TERMINAL GR0UP=GRP1,QBY=T,QUEUES=MR,RLN=1,TERM=LUNT, 

TCM SESN=LUINIT,OPDATA= (80) 

TERMINAL GROUP=GRP1,QBY=T,QUEUES=MR,RLN=1,TERM=LUNT, 
TCMSESN=LUINIT,OPDATA=(00) 

SPACE 2 

TERMINAL TERM=PUNT SECOND 3790 ON THE SAME LINE 

TERMINAL GROUP=GRP1,QBY=T,QUEUES=MR,RLN=1,TERM=LUNT, 

TCMSESN=LUINIT,OPDATA=(80) 

TERMINAL GROUP=GRP1,QBY=T,QUEUBS=MR,RLN=1,TERM=LUNT, 

TCM SESN=LUINIT,OPDATA=(00) 

TERMINAL TERM=LINE,GROUP=GRP1,RLN=2 
TERMINAL TERM=PUNT FIRST 3767 

TERMINAL TERM=LUNT,GROUP=GRPl,QBY=T,QUEUES=MR,RLN=2, 

TCM SESN=LUINIT,OPDATA=(00) 

TERMINAL TERM =PUNT,ACTIVE=YES FIRST 3770 

TERMINAL TERM=LUNT,GR0UP=GRP1,QBY=T,QUEUES=MR,RLN=2, 
TCMSESN=LUINIT,OPDATA= (00) 

TPROCESS PCB=CICSPCB, POINT TO PROCESS CONTROL BLOCK * 

ALTDEST=CLNE, REROUTE BACK AT QUEUE CLEAN—UP * 

QUEUES=MR 

TPROCESS PCB=CICSPCB 
TERMINAL TERM=SSCP 
EJECT 

*********************************************************************** 


X 


X 


X 


SYSTEM SERVICES CONTROL POINT MESSAGE HANDLER 
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*********************************************************************** 
IEDMHGEN SSCP=YBS,TOTE=NO INVOKE IBM—SUPPLIED SSCP MH 

EJECT 


*********************************************************************** 

* 

* DEVICE MESSAGE HANDLER 

* 

♦ * * * * ** ** * * * ♦ * * * **** * * ****** ** * * ****** ** ** * **** * * ** ********* * ** * ****** * 

CICS STARTMH LC=OUT,DFC=FULL,LU=YES 

SPACE 3 

*********************************************************************** 

* 


♦ INPUT MESSAGE HANDLER 

♦ 

*********************************************************************** 


NOTEXR1 


NOHOLD 


♦ 

NOHALT 


NOTDFC 


INHDR 
SETSCAN 0 

LTR RRETURN, RRETURN 
BM INMSG 

LA RSCAN,ONE (RRETURN) 
I ED RH RHIND= (+DFC) 

LTR RRETURN,RRETURN 
BNZ NOTDFC 
IEDRH RHIND= (+BXR) 

LTR RRETURN,RRETURN 
BNZ NOTEXR1 
SETSCAN 4 

LA RSCAN,FOUR (RSCAN) 


RETURN ADDRESS OF DATA 

ZERO LENGTH BUFFER 

BRANCH IF YES 

SET SCAN POINTER 

GET RH 

DFC COMMAND 

BRANCH IF NO 

GET RH 

EXCEPTION REQUEST 
BRANCH IF NO 
POINT TO COMMAND BYTE 
UPDATE SCAN POINTER 


EQU * 

MSGTYPE X■C9• 
IEDRELS 

IEDRH BSTATE=YES 


N RRETURN,RTRMASK 

CLM RRETURN,4,PBETB 

BE NOHOLD 

CLM RRETURN,4,BETB 

BE NOHOLD 

LOCOPT SNACTL 

TM ZERO (RRETURN) ,SNASCD 

BO NOHOLD 

01 ZERO (RRETURN),SNASCD 

TERRSET 
HOLD 
EQU * 

MSGTYPE X *04• 

IEDRELS 

CLC ONE (TWO,RSCAN),SENS1 

BE NOHALT 

CLC ONE (TWO,RSCAN),SENS2 

BE NOHALT 

LOCOPT SNACTL 
NI ZERO (RRETURN) ,255-(SNASCD+SNASDS) 

RESET STATES 


SIGNAL COMMAND 

START OUTPUT 

GET THE BRACKET STATE 

TURN OFF RTR STATE 

PENDING BETB 

BRANCH IF YES 

BETB 

BRANCH IF YES 
GET OPTION FIELD 
CD ALREADY SENT 
BRANCH IF YES 
SET CD SENT 
SET USER ERROR BIT 
PREVENT OUTPUT 


LUSTAT COMMAND 
START OUTPUT 
COMPONENT AVAILABLE 
BRANCH IF YES 
NO DATA TO XMIT 
BRANCH IF YES 
GET OPTION FIELD 


IEDHALT 
EQU * 

MSGTYPE X*C1* 

HOLD 

MSGTYPE , 

B INBOF 

EJECT 

EQU * 

IEDRH BSTATE=YES 
N RRETURN,RTRMASK 


SHUTDOWN COMPLETE COMMAND 
STOP OUTPUT 
ALL OTHER DFC 
NO PROCESSING TO DO 


GET BRACKET STATE 
TURN OFF RTR STATE 
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NOTINB 


SCANSET 

NOTBDS 

NOTFMH 

INBUF 


JUSTEEL 

NOTCD 

INMSG 

INMSG1 


CLM RRETURN,4,BETB 

BE NOTINB 

CLM RRETURN,4,PBETB 

BE NOTINB 

LOCOPT SNACTL 

01 ZERO (RRETURN) ,SNASCD 

EQU * 

IEDRH RHIND= (+EXR) 

LTR RRETURN,RRETURN 

BZ INMSG 

CLI ZERO (RSCAN),ZERO 

BE INBUF 

LR RSCANSVE,RSCAN 

MSGEDIT ( (I,XL2’0000>)) 

LA RSCAN,TWO(RSCAN) 

IEDRH RHIND= (+FMH) 

LTR RRETURN,RRETURN 

BNZ NOTFMH 

TM FMHTYPE (RSCAN),FMHTYP1 
BZ NOTBDS 

TM FMHSEL (RSCAN) ,FMHBDS 

BZ NOTBDS 

IC RWORK,FMHLEN (RSCAN) 

STC RWORK,SCANSET+7 

SETSCAN 1 ,BLANK=NO 
MSGEDIT ( (I ,C •BTCH •) ) 

EQU * 

01 ZERO (RSCANSVB) ,CCBFMH 

EQU * 

FORWARD DEST=C*CLNE• 

INBUF 

IEDRH RHIND= (+CHNGDIR,+EB) 

CLM RRETURN,1,RETCD8 

BE NOTCD 

LOCOPT SNACTL 
NI ZERO (RRETURN) ,255-SNASCD 

TM ZERO (RRETURN) , SNALUT2 

BZ JUSTREL 

TERRSET 
EQU * 

IEDRELS 
EQU * 

INMSG PATH= (SNACTL,X>80 # ) 
CANCELMG X*00060577FF* 

IEDHALT X*00060577FF’ 

MSGGEN X *0000080000•,LUT2MSG 
INMSG 

CANCELMG X *00060577FF* 

IEDHALT X *00060577FF• 

MSGGEN X*0000080000*,RH=X 
INEND 
EJECT 


BETWEEN BRACKETS 
BRANCH IF YES 
PENDING BETWEEN BRACKETS 
BRANCH IF YES 
GET OPTION FIELD 
SET CHANGE DIRECTION STATE 

GET RH 

EXCEPTION REQUEST 
BRANCH IF YES 
NULL RU 
BRANCH IF YES 
SAVE THE SCAN POINTER 
INSERT NO FMH CCB 
POINT TO START OF FMH 
GET RH 
FMH PRESENT 
BRANCH IF NO 
TYPE 1 FMH 
BRANCH IF NO 
BEGIN OF DATASET 
BRANCH IF NO 
GET FMH LENGTH 
SET AMOUNT FOR SETSCAN 
SCAN PAST FMH 

EDIT IN BATCH TRANSACTION NAME 
INDICATE FMH PRESENT 
SEND MESSAGE TO CICS 
GET RH 

CD OR EB PRESENT 
BRANCH IF NO 
GET OPTION FIELD 
RESET CD SENT 
LU TYPE 2 
BRANCH IF NO 
SEND UNLOCK MSGGEN 

START OUTPUT 

LU TYPE 2 INMSG 
CANCEL ON AN ERROR 
END THE SESSION 
RH=X *038040• 

ALL OTHER LU INMSG 
CANCEL ON AN ERROR 
END THE SESSION 
*038020* 


********************************************************************* 


* 


* OUTPUT MH 

♦ 


********************************************************************* 


SPACE 3 
OUTHDR 
SETSCAN 0 

LTR RRETURN,RRETURN 

BP NOT ZERO 

IEDSENSE AREA=(4) 

CLM RWORK ,8,TEMPERR 

BE OUTMSG 


TEST FOR DATA IN BUFFER 
ZERO LENGTH BUFFER 
BRANCH IF NO 
GET THE SNA SENSE 
RECOVERABLE ERROR 
BRANCH IF YES 
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LOCOPT SNACTL 
NI 


GET OPTION FIELD 


♦ 

NOTZERO 


CHKEB 

* 

REMCCB 


OUTMSG 


* 

* 


ZERO (RRETURN) ,255-(SNASDS+SNASCD) 

RESET STATES 

B OUTMSG BRANCH 

EQU * 

LA RSCAN ,ONE (RRETURN ) 

TM ZERO (RSCAN),CCBFMH 

BZ NOFMH 

IEDRH RBIND= (+FMH) 

LOCOPT SNACTL 


NOTBDS1 


NOFMH 


TM FMHTYPE (RSCAN) ,FMHTYPl 

BZ NOFMH 

TM FMHSEL (RSCAN),FMHBDS 

BZ NOTBDS1 

01 ZERO (RRETURN),SNASDS 

EQU * 

TM FMHSEL (RSCAN),FMHEDS 

BZ NOFMH 

NI 


SET SCAN REG 
FMH IN DATA 
BRANCH IF NO 
SET FMH PRESENT 
GET OPTION FIELD 
TYPE 1 FMH 
BRANCH IF NO 
BEGIN OF DATASET 
BRANCH IF NO 
SET IN DATA SET 


END OF DATASET 
BRANCH IF NO 

ZERO (RRETURN),255-SNASDS TURN OFF IN DATASET STATE 
* 

GET BRACKET STATE 
TURN OFF RTR STATE 
BETWEEN BRACKETS 
BRANCH IF NO 
SET BEGIN BRACKET 


EQU 

IEDRH BSTATE=YES 
N RRETURN,RTRMASK 

CLM RRETURN,4,BETB 
BNE CHKEB 
IEDRH RHIND= (+BB) 

EQU * 

LOCOPT SNACTL 

TM ZERO(RRETURN),SNASDS 
BO REMCCB 
NI ZERO (RRETURN), 255- (SNASCD+SN ASDS) 

RESET STATES 

IEDRH RHIND= (+EB) 

EQU * 

MSGBDIT ( (R, ,SCAN, (2) ) ) 

OUTBUF PATH= (SNACTL,X 1 0 1 1 ) 

IEDRH RHIND= (*CHNGDIR) 

L RWORK,IEDADBUF 


GET OPTION FIELD 
IN DATASET STATE 
BRANCH IF YES 


SET END OF BRACKET 


REMOVE CC3 

EXECUTE IF CD REQUIRED 
INSERT CD IN LAST OF CHAIN 
GET CURRENT BUFFER 


TM PRFSTAT1 (RWORK) ,PRFNLSTN LAST BUFFER IN MESSAGE 
BO OUTMSG BRANCH IF NO 

LOCOPT SNACTL GET OPTION FIELD 

NI ZERO (RRETURN) ,255—SNARCD RESET OPTION SWITCH 


01 ZERO (RRETURN) ,SNASCD 
OUTMSG 

HOLD 1*0004000002 *,RELEASE 
HOLD X*0004000012*,RELEASE 
HOLD X *0004000013 *,RELEASE 
HOLD X *0000006000•,INTVL=10 
IEDHALT X*0000010600* 


SET CD SENT 


TEMP ERROR WAIT FOR LUSTAT 
TEMP ERROR WAIT FOR LUSTAT 
BRACKET CONTENTION WAIT FOR EB 
RETRY AFTER WAIT 
END THE SESSION ON NON 
RECOVERABLE ERRORS 

MSGGEN X *0000040008•,MSG2,RH=X"0B8040 * 

ABORT THE DATASET ON ERROR 

MSGGEN X*0000040008*,C*FMH ERROR DS ABORTED*, C 

RH=X•0380C0• 


* INFORM THE OPERATOR 
OUTEND 

EJECT 

* 

* MESSAGE HANDLER FOR CICS APPLICATION PROGRAM 

* 

*******^*******♦***♦*****♦******♦*♦******************* 4 ^************** 

AMH STARTMH 

INHDR 

FORWARD DEST=PUT 
INEND 
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OUTHDR 

OUTEND 




EJECT 




LUT2MSG 

DC 

X'02F1C3 * 

RESET THE KEY BOARD 


LUT1MSG 

DC 

X'O115• 

RETURN THE CARRIAGE 



DS 

OF 

FORCE ALIGNMENT 


RTRMASK 

DC 

X 'FFEFFFFF * 

MASK TO AND OFF RTR 

STATE 

BETB 

DC 

X»00 ■ 

COMPARE FOR BETB 


PBETB 

DC 

X *20 * 

COMPARE FOR PENDING 

BETB 

SENS1 

DC 

X'0001* 

COMPONENT AVAILABLE 


SENS2 

DC 

X*0002 • 

NO DATA TO XMIT 


TEMPERR 

DC 

X *08 • 

REQUEST REJECT ERRORB 

RETCD8 

DC 

X • 08 • 



MSG1 

DC 

X'000000* 

MSG AREA 


MSG2 

DC 

EJECT 

END 

X *0606010000A000' 

ABORT DATASET FMH 



SAMPLE 2: ■DFHSPTM2 - SAMPLE TCAM MCP FOE TCAM DIRECT * 


*********************************************************************** 

* 

* 

* 

* NAME - CICS SAMPLE TCAM MESSAGE CONTROL PROGRAM AND MESSAGE HANDLERS 

* (CONTROLLED BY APPLICATION PROGRAMS) 

* 

* PURPOSE - THE PURPOSE OF THIS SAMPLE IS TO DEMONSTRATE TO THE CICS 

* USER WHAT IS REQUIRED FOR THE CREATION OF A SIMPLE CICS SNA 

* NETWORK USING TCAM. THE SAMPLE DEMONSTRATES HALF-DUPLEX 

* FLIP/FLOP MODE WITH BRACKETS. 

* 

* 

* FUNCTIONS - THE FUNCTIONS ARE AS FOLLOWS: 

* 

* INTRODUCTION - DEFINE THE OVERALL SYSTEM PARAMETERS, INITIALIZE 

* THE SYSTEM, AND START MESSAGE TRAFFIC. 

* 

* DEFINITION - DESCRIBE THE SPECIFICS OF THE NETWORK, THE MESSAGE 

* QUEUES, AND THE NECESSARY CONTROL BLOCKS. 

* 

* DEVICE MESSAGE HANDLER - INSERT THE COMMUNICATIONS CONTROL BYTES 

* AND ROUTE THE MESSAGE FOR INPUT, REMOVE THE CCB AND ROUTE 

* THE MESSAGE TO ITS PROPER DESTINATION ON OUTPUT. THE DMH IS 

* NAMED 'CICS* SO THAT AN LU CAN LOGON TO *CICS». 

* THIS MH SUPPORTS LU TYPEO, TYPE1, AND TYPE2. LU TIPE2 IS THE 

* 3270 DATA STREAM EMULATOR. THE SUPPORT IS DESIGNED TO ALLOW 

* THE TRANSACTION TO CONTROL THE LU. OTHER MODES OF OPERATION 

* ARE POSSIBLE BY USING DIFFERENT MH OPTIONS. THE LU TYPE1 

* BATCH SUPPORT ASSUMES A SINGLE TRANSACTION WILL HANDLE THE 

* BATCH INPUT. THE MH WILL EDIT THE TRANSACTION NAME INTO 

* THE FIRST CHAIN OF THE DATASET. THEREFORE IT IS NOT NECESSARY 

* TO PLACE A TRANSACTION NAME INTO THE DATASET. 

* THIS MH ASSUMES THAT THE TERMINAL WILL BE LOGICALLY TIED 

* TO A TRANSACTION FOR THE DURATION OF A BRACKET. ADDITIONAL 

* FLOW CONTROL WOULD HAVE TO BE ADDED TO HANDLE MESSAGE 

* SWITCHING OR HOST INITIATED BRACKETS. 

* 

* 

* APPLICATION MESSAGE HANDLER - ROUTE MESSAGES FROM THE INPUT QUEUE 

* TO CICS AND FROM CICS TO THE APPROPRIATE OUTPUT QUEUE. 
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* 

♦ 

* THE SSCP MESSAGE HANDLES - UTILIZES THE IBM-SUPPLIED MH TO 

* PERFORM THE NECESSARY ROUTING AND ANALYSIS FUNCTIONS. COMPLEX 

* USER SYSTEMS MAY REQUIRE THIS TO BE MODIFIED BY THE USER. 

* 

* 

* NOTES - 

* 

♦ CONVENTIONS - 

* 

♦ REGISTER 2 IS USED AS THE DCB REGISTER 

♦ 

♦ REGISTER 3 USED AS INTERNAL LINKAGE REGISTER 

♦ 

* REGISTER 4 USED AS INTERNAL WORK REGISTER 

* 

* REGISTER 5 USED AS INTERNAL. WORK REGISTER 

* 

* REGISTER 6 USED AS THE SCAN REGISTER 

♦ 

♦ DEFAULTS - 

* 

* MACRO DEFAULTS ARE USED WHEREVER REASONABLE 

* 

* 

* EXITS - 

* 

* NORMAL - 

* 

* RETURN TO THE OS/VS SUPERVISOR WHEN SHUTDOWN IS COMPLETE 

♦ 

* ERROR - 

♦ 

* X*FFF• - ABEND ON INTRO FAILURE 

♦ 

* X•FFE* - ABEND ON MESSAGE QUEUE DCB OPEN FAILURE 

* 

* X *FFD 1 - ABEND ON 3705 DCB OPEN FAILURE 

* 

* 

* 

* 

*********************************************************************** 

CICSTCAM CSECT 


RDCB 

EQU 

2 

DCB REGISTER 

LINKREG 

EQU 

3 

INTERNAL LINKAGE REGISTER 

RWORK 

EQU 

4 

INTERNAL WORK REGISTER 

RSCANSVE 

EQU 

5 

SAVED SCAN POINTER REGISTER 

RSCAN 

EQU 

6 

SCAN POINTER REGISTER 

RRETURN 

EQU 

15 


OPEN 

EQU 

X • 10 • 

DCB OPEN FLAG 

DCBOFLGS 

EQU 

X'30 1 

OPEN FLAGS OFFSETF 

WORD 

EQU 

4 

OFFSET 


SPACE 2 


♦ 

CCB 

BYTE 0 



SPACE 


CCBFMH 

EQU 

X*01 • 

FORMATTED HEADER 

CCBDISC 

EQU 

X *08 * 

DISCONNECT 


SPACE 2 


* 

CCB 

BYTE 1 


CCBEB 

EQU 

X'01 • 

WRITE LAST SPECIFIED 

CCBCD 

EQU 

X* 02 • 

WRITE WITH READ SPECIFIED 


SPACE 2 
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FMHLEN 

EQU 

0 

BYTE 0 OF FMH 


FMHTYPE 

EQU 

1 

BYTE 1 OF FMH 


FMHSEL 

EQU 

2 

BYTE 2 OF FMH 


FMHSTCK 

EQU 

3 

BYTE 3 OF FMH 


FMHPROP 

EQU 

4 

BYTE 4 OF FMH 


FMHTIP1 

EQU 

X'01 1 

TYPE 1 FMH 


FMHBDS 

EQU 

X^O* 

BEGIN DATASET FMH 


PRFSTAT1 

EQU 

X • 14 1 

STATUS BYTE OFFSET 


PRFNLSTN 

EQU 

X , 02 l 

NOT LAST INDICATOR 


ZERO 

EQU 

0 



ONE 

EQU 

1 



TWO 

EQU 

2 



FOUR 

EQU 

4 



********************************************************************* 


* 

SNACTL OPTION FIELD USAGE 



SNARCD 

EQU 

X'01' 

REMEMBER TO SET CD 


SNASCD 

EQU 

X *02 * 

CD HAS BEEN SENT, TCAM CAN'T 


♦ 



SEND ANY DATA 


SNALUT2 

EQU 

X*80* 

TYPE 2 LU A 3270 DSB 


********************************************************************* 



EJECT 





INTRO 

PBOGID=CICSTC&M, 


X 



UNITSZ=160, 

BUFFER UNIT SIZE 

X 



LNUNITS=100, 

SEE TCAM SYSTEM PGMER'S GUIDE 

X 



BRACKBT=YES, 

INCLUDE BRACKET STATE MANAGER 

X 



BTRACE=500, 

PIU TRACE ENTRIES 

X 



CIB=5, 

MAX 5 ACTIVE OPERATOR COMMANDS 

X 



COMWRTB=YES, 

INCLUDE SERVICE AID WRITER 

X 



COMTROL=OPCTL, 

ALLOW COMMANDS FROM OTHERS 

X 



CPB=20, 

ACTIVE DISK CHANNEL PROGRAMS 

X 



DISK=YES, 

DISK MESSAGE QUEUES 

X 



DLQ=0, 

NO DEAD LETTER QUEUE 

X 



DTRACE=500, 

DISPATCHER TRACE ENTRIES 

X 



FEATURE=(NODIAL,N02741, 

z/ONLY3705/ONLYSNA) / 

X 



MSUNITS=100, 

BUFFER UNITS FOR CORE QUEUE 

X 



MAXSUBA=3, 

OBTAIN FROM NCP GENERATION 

X 



PLCBNO=20 , 

PSEUDO LC3S NEEDED FOR I/O 

X 



PHIBARY=SYSCON, 

OPERATOR CONTROL CONSOLE 

X 



SIBCNT=25, 

MAXIMUM SNA SESSIONS PERMITTED 

X 



SUBAREA=1 

OBTAIN FROM NCP GENERATION 



LTR 

RRETURN,RRBTURN 

WAS INTRO SUCCESSFUL 



BZ 

OKINTRO 

IF SO, CARRY ON 



STH 

RRETURN,DEBUG 

MAKE RETURN CODE VISIBLE 



ABEND 

4095,DUMP 

OTHERWISE/ PUNT WITH X*FFF 1 


OKINTRO 

OPEN 

(NSGQUBOE,(INOUT)) 

OPEN MESSAGE QUEUES DATA SET 



LA 

RDCB,MSGQUEUE 

POINT TO DCB 



TM 

DCBOFLGS (RDCB),OPEN 

WAS OPEN SUCCESSFUL 



BO 

OKOPENQS 

IF SO/ CARRY ON 



ABEND 

4094,DOHP 

OTHERWISE/ PUNT WITH X *FFE 1 


OKOPENQS 

OPEN 

(NCP1DCB, (INOUT) ) 

OPEN 3705 FOR COMMUNICATIONS 



LA 

RDCB,NCP1DCB 

POINT TO 3705 DCB 



TM 

DCBOFLGS(RDCB),OPEN 

WAS OPEN SUCCESSFUL 



BO 

OKOPEN05 

IF SO/ CARRY ON 



ABEND 

4093,DUMP 

OTHERWISE/ PUNT WITH X *FFD * 


OKOPEN05 

READY 


LET TCAM START TRAFFIC 



CLOSE 

(NCP1DCB , , MSGQUE UB ,) 




RETURN (14 # 12) RELINQUISH CONTROL 

EJECT 

*********************************************************************** 

* 

♦ DEFINE THE CONFIGURATION OF THE NETWORK - PHYSICAL AND LOGICAL 

* 

*********************************************************************** 
SPACE 2 
DS OD 
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DC 

DEBUG DS 
DC 

MSGQUEUE DCB 


RETURN CODE = # 


NCP1DCB DCB 


CICSPCB PCB 


SNACTL 

NCP1 

GRP 1 


LI 


PU1 

P1T1 

P1T2 

P1T3 

P1T4 


PU2 

P2T1 

P2T2 

L2 

PU3 

P3T1 

PU4 

P4T1 

CLNE 


TLNE 

SSCP 


C* 

H 

C 1 • 

DSORG=TQ, 

DDNAME=MSGQUEUE , 
MACRF=(G,P) , 

OPTCD=R 
DSORG=TR , 

DDNAME=DDNCP1 f 
MACRF= (G,P) 

MH^AMH , BUFSIZE=2000 
TTABLE LAST=SSCP 
OPTION XL 1 

TERMINAL DCB=NCP1DCB, 

TERM=LNCP,IPLTXID=NCP1TXT 


TRIGGER FOR DUMP SCANNING 
TO CONTAIN INTRO RETURN CODE 
SPACING AROUND MESSAGE 
MESSAGE QUEUE DATA SET 


X 
X 
X 

REUSABLE DISK QUEUES 

3705 COMMUNICATIONS CONTROLLER X 

X 

APPLICATION PROGRAM MH 
TERMINAL TABLE START AND END 

POINT TO PROPER 3705 X 


GROUP MH=CICS,BUFSIZE=288, 
OPACING=2 

TERMINAL TERM=LINE, 
GROUP=GRP1, 

RLN=1, 

ACTIVE=YES 

TERMINAL TERM=PUNT 


POINT TO DEVICE MESSAGE HANDLERX 
DEFINE HOST PACING 
DEFINE FIRST SDLC LINE X 

POINT TO PROPER GROUP X 

FIRST LINE X 

ACTIVATE LINE AUTOMATICALLY 
3790 PHYSICAL UNIT - 

TERMINAL GROUP=GRPl,QBY=T,QUEUES=MR,RLN=1,TERM=LUNT, X 

TCMSESN=LUINIT,OPDATA=(80) 

TERMINAL GROUP=GRP1,QBY=T,QUEUES=HR,RLN=1,TERM=LUNT, X 

TCMSESN=LUINIT,OPDATA= (80) 

TERMINAL GROUP=GRP1,QBY=T # QUEUES=MR # RLN=1,TBRM=LUNT , X 

TCMSESN=LUINIT,OPDATA=(80) 

TERMINAL GROUP=GRP1 / QBY=T,QUEUES=MR # RLN=1,TERM=LUNT r X 

TCMSESN=LUINIT,OPDATA=(00) 

SPACE 2 

TERMINAL TERM=PUNT SECOND 3790 ON THE SAME LINE 

TERMINAL GR0UP=GRP1,QBY=T # QUEUES=MR,RLN=1,TERM=LUNT, X 

TCMSESN=LUINIT ,OPDATA=(80) 

TERMINAL GR0UP=GRP1,QBY=T,QUEUES=MR,RLN=1,TERM=LUNT, X 

TCMSESN=LUINIT,OPDATA=(00) 

TERMINAL TERM=LINE r GROUP=GRP1,RLN=2 

TERMINAL TERM=PUNT FIRST 3767 

TERMINAL TERM=LUNT,GROUP=GRP1,QBY=T,QUEUES=MR,RLN=2, X 

TCMSESN=LUINIT,OPDATA= (00) 

TERMINAL TERM=PUNT,ACTIVE=YES FIRST 3770 

TERMINAL TER M =LU NT,GRO UP=GRP1,QBY=T,QUEUBS=MR,RLN=2, X 

TCMSESN=LUINIT r OPDATA= (00) 

TPROCESS PCB^CICSPCB, POINT TO PROCESS CONTROL BLOCK * 

ALTDEST=CLNE , REROUTE BACK AT QUEUE CLEAN-UP * 

QUEUES=MR 

TPROCESS PCB=CICSPCB 

TERMINAL TERM=SSCP 

EJECT 

*********************************************************************** 

* 

* SYSTEM SERVICES CONTROL POINT MESSAGE HANDLER 

* 

*********************************************************************** 
IEDMHGEN SSCP=YES,TOTE=NO INVOKE IBM-SUPPLIED SSCP MH 
EJECT 

*********************************************************************** 

* DEVICE MESSAGE HANDLER 

* 

*********************************************************************** 

CICS STARTMH LC=OUT,DFC=FULL,LU=YES 

SPACE 3 

*********************************************************************** 
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* INPUT MESSAGE HANDLER 

* 

*********************************************************************** 

INHDR 


N0TEXR1 


LUTYP1 

SETESR 


NO HOL D 


NOHALT 


NOTDFC 


SETSCAN 0 

LTR REE TUR N , RR ET URN 

BM INMSG 

LA RSCAN ,ONE (RRETURN) 

IEDRH RHIND=(+DPC) 

LTR RRETURN,RRETURN 

BNZ NOTDFC 

IEDRH RHIND= (+EXR) 

LTR RRETURN,RRETURN 

BNZ NOTEXR1 

SETSCAN 4 

LA RSCAN/FOUR (RSCAN) 

EQU * 

MSGTYPE X *C9 f 
IEDRH BSTATE=YES 

N RRETURN,RTRMASK 

CLM RRETURN,4, PBETB 

BE NOHOLD 

CLM RRETURN,4,BETB 

BE NOHOLD 

LOCOPT SNACTL 

TM ZERO (RRETURN) ,SNA5CD 

BO NOHOLD 

TM ZERO (RRETURN ),SNALUT2 

BZ LUTYP1 

MVC MSG1 (L •LUT2MSG) ,LUT2MSG 
B SETERR 

EQU * 

MVC MSG1 (L *LUT1MSG) ,LUTlMSG 
EQU * 

01 ZERO (RRETURN),SNASCD 

TERRSET 

HOLD 

EQU * 

MSGTYPE X *04 * 

IEDRELS 

CLC ONE (TWO,RSCAN) ,SENS1 

BE NOHALT 

CLC ONE (TWO,RSCAN),SENS2 

BE NOHALT 

IEDHALT 
EQU * 

MSGTYPE X*C1* 

HOLD 

MSGTYPE , 

B INBUF 

EJECT 

EQU * 

IEDRH RHIND= (+EXR) 

LTR RRETURN,RRETURN 

BZ INMSG 

CLI ZERO (RSCAN) ,ZERO 

BE INBUF 

LR RSCANSVE,RSCAN 

MSGEDIT ( (I,XL2 f OOOO*)) 

LA RSCAN,TWO(RSCAN) 

IEDRH RHIND= (+FMH) 

LTR RRETURN,RRETURN 

BNZ NOTFMH 

TM FMHTYPE(RSCAN),FMHTYP1 


RETURN ADDRESS OF DATA 

ZERO LENGTH BUFFER 

BRANCH IF YES 

SET SCAN POINTER 

GET RH 

DFC COMMAND 

BRANCH IF NO 

GET RH 

EXCEPTION REQUEST 
BRANCH IF NO 
POINT TO COMMAND BYTE 
UPDATE SCAN POINTER 

SIGNAL COMMAND 

GET THE BRACKET STATE 

TURN OFF RTR STATE 

PENDING BETB 

BRANCH IF YES 

BETB 

BRANCH IF YES 

GET OPTION FIELD 

CD ALREADY SENT 

BRANCH IF YES 

TYPE 2 LU 

BRANCH IF NO 

SET LU TYPE 2 MESSAGE 

BRANCH 

SET LU TYPE 1 MESSAGE 

SET CD SENT 

SET USER ERROR BIT 

PREVENT OUTPUT 

LUSTAT COMMAND 
START OUTPUT 
COMPONET AVAILABLE 
BRANCH IF YES 
NO DATA TO XMIT 
BRANCH IF YES 


SHUTDOWN COMPLETE COMMAND 
STOP OUTPUT 
ALL OTHER DFC 
NO PROCESSING TO DO 


GET RH 

EXCEPTION REQUEST 

BRANCH IF YES 

NULL RU 

BRANCH IF YES 

SAVE THE SCAN POINTER 

INSERT NO FMH CCB 

POINT TO START OF FMH 

GET RH 

FMH PRESENT 

BRANCH IF NO 

TYPE 1 FMH 
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SCANSET 

NOTBDS 

NOTFMH 

INBUF 


NOTCD 

INMSG 


BZ NOT BDS 

TM FMHSEL (RSCAN),FMHBDS 

BZ NOTBDS 

IC RWORK r FMHLEN (RSCAN) 

STC R WORK,SCANSET +7 

SETSCAN 1,BLANK=NO 
MSG EDIT ( (I,C*BTCH*)) 

EQU * 

01 ZERO (RSCANSVE) ,CCBFMH 

EQU * 

FORWARD DEST=C *CLNE* 

INBUF 

IEDRH RHIND= (+CHNGDIR) 

LTR RRETURN,RRETURN 

BNZ NOTCD 

LOCOPT SNACTL 
NI ZERO (RRETURN) ,255-SNASCD 

IEDRELS 
EQU * 

INMSG 

CANCBLMG X•00060577FF• 

IEDHALT X•00060577FF• 

MSGGEN X *0000080000 * ,MSG1 # RH : 

INEND 

EJECT 


BRANCH IF NO 

BEGIN OF DATASET 

BRANCH IF NO 

GET FMH LENGTH 

SET AMOUNT FOR SETSCAN 

SCAN PAST FMH 

EDIT IN BATCH TRANSACTION NAME 

INDICATE FMH PRESENT 

SEND MESSAGE TO CICS 

GET RH 
CD PRESENT 
BRANCH IF NO 
GET OPTION FIELD 
RESET CD SENT 
START OUTPUT 


CANCEL ON AN ERROR 
END THE SESSION 
: X *038020 * 
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********************************************************************* 

* 


* OUTPUT mh 

♦ 


********************************************************************* 


* 

NOTDISC 


NOFMH 


CHKEB 


CHKCD 


REMCCB 


OUTMSG 


* 

* 


SPACE 3 
OUTHDR 
SETSCAN 0 

LTR RRETURN,RRETURN 

BM OUTMSG 

LA RSCANYONE (RRETURN) 

TM ZERO (RSCAN),CCBDISC 
BZ NOTDISC 
CANCELMG 
B OUTMSG 

EQU * 

TM ZERO (RSCAN) ,CCBFMH 

BZ NOFMH 

IEDRH RHIND= (+FMH) 

EQU * 

IEDRH BSTATE=YES 
N RRETURN,RTRMASK 

CLM RRETURN, 4,BETB 
BNB CHKEB 
IEDRH RHIND= (+BB) 

EQU * 

TM ONE (RSCAN) ,CCBEB 
BZ CHKCD 
IEDRH RHIND= (+EB) 

LOCOPT SNACTL 

NI ZERO (RRETURN) ,255-SNASCD 
B REMCCB 

EQU * 

TM ONE (RSCAN) ,CCBCD 

BZ REMCCB 

HOLD 

LOCOPT SNACTL 

01 ZERO (RRETURN) ,SNARCD 

EQU * 

MSGEDIT ((R,,SCAN, (2))) 

OUTBUF PATH= (SNACTL,X *0 1 *) 
IEDRH RHIND= (*CHNGDIR) 

L RWORK,IEDADBUF 

TM PRFSTAT1 (RWORK),PRFNLSTN 
BO OUTMSG 
LOCOPT SNACTL 

NI ZERO (RRETURN) ,255-SNARCD 
01 ZERO (RRETURN) ,SNASCD 
OUTMSG 

HOLD X f 0004000002* ,RELEASE 
HOLD X•0004000012»,RELEASE 
HOLD X•0 000006000 1 ,INTVL=10 
IEDHALT X 1 0000009000»,CONNECT= 

IEDHALT X •0000050600* 


TEST FOR DATA IN BUFFER 
ZERO LENGTH BUFFER 
BRANCH IF YES 
SET SCAN REG 
SESSION END REQUESTED 
BRANCH IF NO 

STOP THE MESSAGE, END THE 
SESSION AND QUIT PROCESSING 

FMH IN DATA 
BRANCH IF NO 
SET FMH PRESENT 

GET BRACKET STATE 
TURN OFF RTR STATE 
BETWEEN BRACKETS 
BRANCH IF NO 
SET BEGIN BRACKET 

END OF TRANSACTION 
BRANCH IF NO 
SET END OF BRACKET 
GET OPTION FIELD 
RESET CD SENT 
GO REMOVE CCB 

INPUT FROM TERMINAL WANTED 

BRANCH IF NO 

STOP FURTHER OUTPUT 

GET OPTION FIELD 

SET PATH SWITCH TO SET CD 

REMOVE CCB 

EXECUTE IF CD REQUIRED 
INSERT CD IN LAST OF CHAIN 
GET CURRENT BUFFER 
LAST BUFFER IN MESSAGE 
BRANCH IF NO 
GET OPTION FIELD 
RESET OPTION SWITCH 
SET CD SENT 

TEMP ERROR WAIT FOR LUSTAT 
TEMP ERROR WAIT FOR LUSTAT 
RETRY AFTER WAIT 
AND 

END THE SESSION IF REQUESTED 
END THE SESSION ON NON 
RECOVERABLE ERRORS 


OUTEND 

EJECT 

*********************************************************************** 


* 


♦ MESSAGE HANDLER FOR CICS APPLICATION PROGRAM 

* 

*********************************************************************** 


AMH STARTMH 
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LUT2MSG 

INHDR 

FORWARD DEST=PUT 

INEND 

OUTHDR 

OUTEND 

EJECT 

DC X•02F1C3 • 

RESET TBE KEY BOARD 


LOTI MSG 

DC 

X * 0115 * 

RETURN THE CARRIAGE 


BTRMASK 

DS 

DC 

OF 

X ‘FFEFFFFF * 

FORCE ALIGNMENT 

MASK TO AND OFF RTR 

STATE 

BETB 

DC 

X*00» 

COMPARE FOR BETB 


PBETB 

DC 

X 1 20 1 

COMPARE FOR PENDING 

BETB 

SENS 1 

DC 

X*0001» 

COMPONENT AVAILABLE 
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Index 


ach page number in this index refers to the start of the paragraph containing the 
ndexed item. 


BCODE operand 

DFHSRT TYPE=SYSTEM/USER 237 
bend 

abend/restart, TCAM 527 
codes, DFHSRT TYPE=SYSTEft/USER 236 
DFHSRT TYPE=SYSTEM/USER 236 
OS/VS codes 237 
program isolation deadlock 347 
recovery 237 
system or user codes 236 
transaction bit 392 
VSE codes 238 
BKPOPT operand 205 
bnormal conditions 

sample node error program 401 
sample terminal error program 365 
user-written node error programs 408 
user—written terminal error 
programs 387 

bnormal termination 416,427 
CB (access method control block) 488 
ccess method control block (ACB) 488 
CCMETH operand 

DFHFCT TYPE-ALTERRATE 104 
DFHFCT TYPE=DATASET 107 
DFHSG PROGRAM=TCP 57 
DFHTCT TYPE=INITIAL 248 
DFHTCT TYPE=LINE 266 
DFHTCT TYPE=REMOTE 281 
DFHTCT TYPE=SYSTEM 293 
DFHTCT TYPE=TERftINAL 302 
CCOUNT operand 143 
ccounting class 679 
ccounting information 16 
CCTID operand 16 
CF/VTAM 4 85 

access method control block (ACB) 488 
action flags set by DFHZNAC 498 
APPLID operand 488 
BMS 503 

BftSDEV operand 503 
chain assembly (CHNASSY) 491 
CICS/VS good morning message 249 
CO N N ECT= AUTO 489 
devices 67 

DFHPCT TYPE=OPTGRP 493 
DFflTC CTYPE=COMMAND 487 
DFHTC CTYPE=STATOfS 502 
DFBTCP, DFHZCP 486 
DFHZNAC 757 

DFHZNAC logging facility 500 
DVSUPRT operand 501 
emergency restart 495 
error actions 757 
I/O error handling 

DFHZNAC/DFHZNEP 496 
indicators 

DFHTC CTYPE=COftMAND 579 
JFILEID operand 501 
logical record presentation 504 
logical units with CICS/VS 485 


A CF/V TA ft (contin ued) 

mapping individual records and entire 
chains 504 
message cache 495 
message logging 493 
message option groups 493 
message protection processing 493 
message recovery 492 
message recovery and emergency 
restart 492 
message switching 505 
HSGJRNL operand 501 
MSGPREQ operand 493 

multiprocessor recovery procedures 476 

node abnormal condition program 496 

node initialization block (NIB) 488 

noncatastrophic failures 496 

nonprotected tasks 493 

operand 20 

protected tasks 493 

RAHAX operand 490 

RATIftES operand 490 

RECEIVE macro 489 

RELREQ exit—routine 489 

ROUTING operand 503 

RPL pool size 504 

RPLs 490 

session failures, user actions 
user—written NEPs 414 
session types 281,300 
SIMLOGON 309 

SNA commands (indicators) 487,588 
statistics 504 

system sense codes received 772 
terminal control, DFHTC macros 500 
terminal/logical units 281,300 
transaction class 497 
transaction options 501 
transaction-class error routine 497 
TRMIDNT operand 505 
TRftSTAT operand 501 

user exit routines for CICS/VS terminal 
control 502 
XZCATT exit 502 
ZINPUT exit 502 
action bits, TACLE 391 
action flag names, DFHTEP 372 
action flags set by DFHZNAC 498 
active tasks 471 
activity keypointing 

DFHSG PROGRAft=KPP 50 
frequency 205 
user 474 

ADRSPCB operand 83,153 

AKP operand 50 

AKPFREQ operand 205 

alarm feature, 3270 display 310 

ALIGN operand 82,152 

alignment, trace table entries 157 

ALT operand 205 

ALT, application load table (DFHALT) 81 
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alternate 

index structure 120 
map suffix 

DFHTCT TYPE=GPENTRY 254 
DFHTCT TY?E=TERMINAL 304 
page size 281,302 
screen size 

DFHTCT TYPE=GPENTRY 253 
DFHTCT TYPE=REMOTE 281 
DFHTCT TYPE=TERMINAL 303 
alternative printer 303 
ALTPGE operand 281,302 
ALTPRT operand 303,319 
ALTSCRN operand 303 

DFHTCT TYPE=GPENTRY 253 
DFHTCT TYPE=RBMOTE 281 
ALTSFX operand 

DFHTCT TYPE=GPENTRY 254 
DFHTCT TYPE=TBRMINAL 304 
AMXT operand 206 
ANS COBOL compilers 52 
answering list 274 
ANSWRBK operand 58,269 
anticipatory paging 

ANTICPG operand 165 
CICSSVC 21 
ANTICPG operand 165 
appendage routine, 7770 37,289 

APPENDG operand 289 
application function timings 618 
application load table (DFHALT) 81 
application programming, journal 
control 435 

closing journal data sets, DFHJC 
TYPE=CLOSE 438 

opening journal data sets, DFHJC 
TYPE=0PEN 435 

reading journal data sets, DFHJC 
TYPE=GET 439 
APPLID operand 
ACF/VTAM 488 
DFHSIT 206 

DFHTCT TYPE=INITIAL 248 
ARGTYP operand 123 
argument type 123 
ASMBLR operand 16 
assembler programs 

LANG operand 42,45 
PGMLANG operand 193 
asynchronous transaction processing 
CRDR exit routine 570 
CWTR exit routine 572 
program (DFHSG PROGRAM=ATP) 24 
user exits 569 
ATP operand 207 
ATPINS operand 207 
ATPMB operand 207 
ATPMT operand 207 
ATPOUTS operand 207 

audible alarm feature, 3270 display 310 

ADTOJRN operand 44,48 

automatic 

answering feature 272 
calling feature 272 
journaling 

AUTOJRN operand 44,48 
logical units 171,182 
logging 49,431 


au tom atic (c ontin ued) 
logging (continued) 
to system log 115 
logon 309 

polling feature 272 
statistics 36,38 
task/transaction initiation 
(ATI) 59,501 

automatically initiated transactions 613 

autopoll feature 287 

AUTOTRN operand 59 

AUX operand 70,71 

auxiliary storage 71 

average service time, disks 661 


background pathlengths 628 
background processor utilization 615 
BASE operand 120 
BASE transaction timings 617 
basic function, DFHSG PROGRAM=BFP 24 
basic mapping support (see BMS) 
basic telecommunications access method 
(see BTAM) 

batch data interchange program (DFHSG 
PROGRAMEDIP) 40 
batch processing, TCAM SNA 510 
batch region communication, DFHTCT 
TYPE=IRCBCH 259 
BFP operand 207 

BFP, built-in functions program (DFHSG 
PROGRAM=BFP) 24 

binary synchronous communication 
BSCODE operand 

DFHSG PROGRAM=TCP 59 
DFHTCT TYPE=LINE 270 
DFHTCT TYPE=SDSCI 284 
CONFIG operand 286 
DFHTCT TYPE=LINE 265 
line configuration 286 
BLKKEYL operand 110 
BLKSIZE operand 

DFHDCT TYPE=SDSCI 94 
DFHFCT TYPE=DATASET 111 
DFHTCT TYPE=SDSCI 284 
block size 

restart data set 51 
sequential devices 255 
TCAM queues 284 
blocking factor 120 
BMS 

BMSFEAT operand 281,304 

device—dependent mapsets 27,193 

DFHSG PROGRAM=BMS 25 

diagnostics 29 

logical units 503 

map use count 196 

mapset suffixes 193 

operand of DFHSIT 208 

page building routines 30 

page commands of DFHSIT 216 

page—retrieval command 217 

pageout routines 30 

printer support 31 

program (DFHSG PROGRAM=BMS) 25 

purge routines 31 

system generation 25 

text building routines 32 
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: features 281,304 

1, basic mapping support program (DFHSG 
tOGRAN=BMS) 25 
iCPYC operand 27 
IDDS operand 27 
;DEV operand 27,503 
5DIAG operand 29 
;DRT operand 29 
JFEAT operand 281,304 
;FMP operand 29 
>FRL operand 30 
IMBD operand 30 
>NL operand 30 
JPB operand 30 
>PGO operand 30 
>PRG operand 31 
>PR0P operand 31 
5RCVR operand 31 
>SMI operand 31 
>TAB operand 32 
>TXB operand 32 
tCKET operand 305 
Lcket protocol 305 
:ODE operand 
DFHSG PROGRAM=TCP 59 
DFHTCT TYPE=LINE 270 
DFHTCT TYPE=SDSCI 284 
{ft 

BTANDEV operand 59 

BTAMRLN operand 270 

define—terminal—list macro 274 

devic^ types 59,282 

DFTRMLST macro 323 

error messages and codes 753 

expanded ID verification 58,270 

FEES operand 224 

module names 250 

multiprocessor recovery procedures 476 
relative line number 270 
terminal address 323 
terminal errors 

terminal abnormal condition 
program 363 

terminal control program 363 
terminal error program 363 
3270 print feature 311 
U5DEV operand 59 
IHRLN operand 270 
:f er 

BUFFER operand 491 

DFHTCT TYPE=SYSTEH 294 
DFHTCT TYPE=TERHINAL 305 
BUFFERS operand 

DFHFCT TYPE=SHRCTL 131 
BUFND operand 

DFHFCT TYPE=ALTERNATE 105 
DFHFCT TYPB=DATASET 111 
BUFNI operand 

DFHFCT TYPE=DATASET 111 
BUFNO operand 

DFHDCT TYPE=SDSCI 94 
BUFSIZE operand 137 
3UFSP operand 

DFHFCT TYPE=DATASET 112 
BUFSUV operand 138,434 
depletion, 3600 BSC 546 
dynamic 209 

expansion feature (2980) 311 


buffer (continued) 

factors in selecting size 433 
maximum size 433 
minimum size 433 
pool size 225 
receive feature 273 
shift-up value 138,433 
sizes 305,432 
BUFND operand 105,111 
BUFNI operand 105,111 
BUFNO operand 94 
BUFPL operand 225 
BUFSIZE operand 137 
BUFSP operand 112 
BUFSUV operand 138,434 
built-in functions program (DFHSG 
PROGRAM=BFP) 24 
BUILTIN operand 25 


CAA operand 37 

calculate disk device service times 655 
data transfer time 655 
rotational position sensing 656 
seek time 655 

calculate transaction processor 
utilizations 615 

relative power factors 615 
card reader/line printer (CRLP) 

BMSDEV=CRLP 27 
TCT example 716 
TRHTYPE=CRLP 268 
chain assembly 

inbound 61,307 
outbound 180,494 

channel reconfiguration hardware (CRH) 476 
CHECK operand 600 
checking feature 
VRC/LRC 273 
CHNASSY operand 

DFHTCT TYPE=TERHINAL 307 
logical units 491 
CICS/OS/VS/TCAH interface 507 
TCAM 511 
TCAM SNA 508 
CICS/VS 

dynamic storage area 638 
external security program 224 
function timings 617 
management module exits 560 
management programs 11 
module sizes 630 
monitoring facilities 141,679 
performance aspects 609 
reference set 645 
service programs 11 
statistics 745 
storage requirements 630 
system generation 13 
system tables 81 
table sizes 635 
user exit interface 551 
utility program 11 
CICSSVC operand 21 
CLASS operand 

DFHALT TYPE=ENTRY 82 
DFHHCT TYPE=BHP 142 
DFEHCT TYPE=RECORD 145 
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CLASS operand (continued) 

DFHPCT TYPE=ENTRY 166 
DFHSG TYPE=INITIAL 22 
DFHTCT TYPE=LINE 270 
DFHTCT TYPE=TERMINAL 307 
closing data sets, DFHOC TYPE=CLOSE 603 
closing journal data sets, DFHJC 
TYPE=CLOSE 438 
CMP operand 208 
CMPT60L operand 62 
CMXT operand 208 
COBOL 

compilers 52 
operand 52 
programs 

LANG operand 42,45 
PGMLANG operand 193 
code compatibility 5 

non—compatible interfaces 7 
object-compatible interfaces 6 
source-compatible interfaces 7 
CODE operand 

DFHSNEP TYPE=ERRPROC 411 
DFHTEPM TYPE=ERRPROC 379 
DFHTEPT TYPE=BUCKET 385 
DFHTEPT TYPE=PERMCODE/ERRCODE 383 
coding macro instructions 11 
command language translator program (DFHSG 
PROGRAM=EXP) 41 
COMMAND operand 588 

command option (logical units), DFHTC 
CTYPE=COMMAND 588 

common subroutine vector table 403,413 
common subroutines, DFHTEP 369 
common system area (DFHSG PROGRAM=CSA) 34 
communication control byte (s) 509,521 

communication lines 
first entry 290 

communication lines, DFHTCT TYPE=LINE 
TCAM SNA devices 279 

terminal control table line entry 265 
communication with batch regions, DFHTCT 
TYPE=IRCBCH 

DL/X shared data base support 259 
COMPAT operand 

DFHPCT TYPE=ENTRY 167 
DFHSG PROGRAM=BMS 32 
DFHSG PROGRAM=TCP 62 
DFHTCT TYPE=TERMINAL 308 
CONDCD operand 22 
CONFIG operand 236 
configurator 
DFHFCT 102 
DFHTCT 240 

CONNECT=AUTO operand 309,489 
CONSLID operand 327 

control block and area prefix fields 6 
control system dummy group (DFHSG 
PROGRAM=CSD) 34 

control system operational group (DFHSG 
PROGRAM=CSO) 35 

control system service group (DFHSG 
PROGRAM=CSS) 38 

control system utility group (DFHSG 
PROGRAM=CSU) 38 
control tables 79 
control unit address 254 
CONV=YES operand 145 


conversational transactions 613 
CICS/VS reference set 646 
CONVTAB operand 63,271 
copy feature (3270) 311 

count limits, default threshold 383 
COUNT operand 383,407 
CPU operand 145 

CRDR exit routine, input processor (ATP) 
cross—index data set record, DFHFCT 
TYPE=INDACC 123 
CS=NO operand 406 
CSA operand 208 
CSA, common system area (DFHSG 
PROGRAM=CSA) 34 

CSD, control system dummy (DFHSG 
PROGRAM=CSD) 34 

CSO, control system operational (DFHSG 
PROGRAM=CSO) 35 

CSS, control system service group (DFHSG 
PROGRAM=CSS) 38 

CSU, control system utility group (DFHSG 
PROGRAM=CSU) 38 
CTLCHR operand 96 
CTYPE macros, DFHTC 579 
CTYPE=CHECK 586 
TYPE=C0MMAND 588 
TYPB=LOCATE 579 
TYPE=STATUS 583 
CTYPB=CHECK operand, DFHTC 587 
CTYPE=COMMAND operand, DFHTC 588 
CTYPE=LOCATE operand, DFHTC 580 
CTYPE=STATUS operand, DFHTC 584 
CU operand 287 
CUADDR operand 254 
CUFEAT operand 254 
CUPOSN operand 254 
CWTR exit routine, output processor 
(ATP) 572 
cylinder 

index area 113 
overflow records 119 
CYLOFL operand 119 


DAM/BDAM intrapartition queues 69 
DASD 

seek times 658 
timing data 656 
data base nackout, DFHTBP 459 
data base description Dlock (DBD) 350 

data base descriptions (DBDs) 345 
data buffers 111 

data definition (DD) statement 289 
data format, TCAM 512 
data language/I (see DL/I) 

data management block (DMB) pool size 226 
data management block directory list 
(DDIR) 349 
DATA operand 105,121 
data set 

control name 271 
nonresident extrapartition 97 
data sets 599 

control blocks 93 
control information 

DFHDCT TYPE=SDSCI 93 
DFHTCT TYPE=SDSCI 281 
control name 284 
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Lta sets (continued) 
definition, DFHFCT TYPE=DATASET 105 
duplicate 124 

dynamic open/close function 599 
phonetic codes and keys 605 
recovery 455 
reusable, VSAM 109 
statistics output 748 
ita transfer time 655 
Lta written to system log 461 
lTAID operand 336,337 
DFHTST TYPB=SECURITY 338 
kTASET operand 

DFHFCT TYPE=ALTERNATE 104 
DFHFCT TYPE=DATASET 107 
DFHFCT TYPE=RBMOTB 126 
DFHMCT TYPB=RECORD 145 
DFHOC TYPE-CLOSE 603 
DFHOC TYPE=OPEN 599 
^TASET=DUMP operand 604 
kTASTR operand 

DFHPCT TYPE=SYSTEM 294 
LTFORM operand 209 
*D operand 350 
)P operand 209 

JP, dynamic backout program (DFHSG 
>ROGRAM=D3P) 39 
&UFSZ operand 209 
:b information 281 
:p operand 209 

:P, dump control program (DFHSG 
>ROGRAM=DCP) 39 
:T operand 210 

:T, destination control table (DFHDCT) 84 

) card correlation 511 

>IR operand 225 

>NAME operand 289 

padlock time-out value 168 

SBCHK operand 21 

^blocking technique 124 

2CB 

information 372 
operand 372 
>fault 

actions taken by DFHTACP 
DFHTEP 753 
TCAM 520 

data base backout 459 
load order (DFHNLT) 147 
page size 281,316 
threshold count limits 383,385 
transaction—class routine 409 
3270 screen size 281,309 
SFAULT operand 409 

*fine terminal error blocks, DFHTEPT 
CYP£=PERMTID 382 

^fining transactions and transaction 
crates 613 

automatically initiated 
transactions 613 
conversational transactions 613 
non—conversational transactions 613 
transaction types 613 
3FSCRN operand 281,309 
SSTFAC operand 89 
SSTID operand 

DFHDCT TYPE=EXTRA 87 
DFHDCT TYPE=INDIRECT 89 


DESTID operand (continued) 

DFHDCT TYPE=INTRA 89 
DFHDCT TYPE=REMOTE 92 
destination control table (DFHDCT) 84 
destination identification 
DESTID operand 

DFHDCT TYPE=EXTRA 87 
DFHDCT TYPE=INDIRECT 89 
DFHDCT TYPE=INTRA 89 
DFHDCT TYPE=REMOTE 92 
DSETID, DFHOC 600,603 
destination selection 261 
DESTRCV operand 69,90 
DEVADDR operand 

DFHDCT TYPE=SDSCI 96 
DFHJCT TYPE=ENTRY 139 
DFHSG P£OGRAM=DCP 40 
DFHSG PROGRAM=TRP 71 
DFHTCT TYPE=SDSCI 287 
device 

classification 270,307 
message handler (DMH) 508 
types 

ACF/VTAH 67 
BTAH 59 
DEVICE operand 


DFHDCT 

TYPE=INITIAL 

. 86 

DFHDCT 

TYPB=SDSCI 

96 

DFHFCT 

TYPE=DATASET 

119 

DFHSG 

PROGRAM=DCP 

40 

DFHSG 

PROGRAM=KPP 

51 

DFHSG 

PROGRAM=TCP 

63 

DFHSG 

PROGRAM-TRP 

71 

DFHSG 

TYPE=INITIAL 

20 

DFHTCT 

TYPE=SDSCI 

282 


device—dependent mapset suffixes 27,193 
DFHACEE — security identification 
module 593 
DFHALT 81 

control section, DFHALT TYPE=IHITIAL 81 
end of application load table, DFHALT 
TYPE=FINAL 83 
DFHALT TYPE=EHTRY 82 
ADRSPCE operand 83 
ALIGN operand 82 
CLASS operand 82 
FIX operand 83 
page—alignment 82 
page—fixing 83 
PAGEOUT operand 83 
program load seguence, DFHALT 
TYPE=ENTRY 82 
PROGRAM operand 82 
TYPE=ENTRY operand 82 
DFHALT TYPE=FINAL 84 
DFHALT TYPB=INITIAL 81 
SUFFIX operand 82 
TYPE=INITIAL operand 82 
DFHBIF TYPE=PHONETIC 605 
DFHCCMF 35 
DFHCMON 35 
DFHCMP 35 
DFHDCT 84 

end of destination control table, 

DFHDCT TYPE=FINAL 97 
examples 98 

extrapartition destinations, DFHDCT 
TYPE=EXTRA 87 
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DFHDCT (co ntin ued) 

indirect data destinations, DFHDCT 
TYPE=INDIRECT 88 

intrapartition destinations, DFHDCT 
TYPE=INTRA 89 

nonresident extrapartition data sets 97 
remote transient data destinations, 
DFHDCT TYPE=REMOTE 92 
reguired entries 691 
trigger level 84 
DFHDCT TYPE = REMOTE 
RSL operand 93 
DFHDCT TYPE=EXTRA 87 
DESTID operand 87 
DSCNAME operand 87 
OPEN operand 87 
RESIDNT operand 88 
RSL operand 88 
TYPE=EXTRA operand 87 
DFHDCT TYPE=FINAL 97 
DFHDCT TYPE=INDIRECT 88 
DESTID operand 89 
INDDEST operand 89 
TYPE=INDIRECT operand 88 
DFHDCT TYPE^INITIAL 85 

control section, DFHDCT TYPE=INITIAL 85 
DEVICE operand 86 
INDEX operand 85 
SEPASMB operand 86 
SUFFIX operand 85 
TRNSUFX operand 86 
TYPE=INITIAL operand 85 
DFHDCT TYPE-INTRA 89 
DESTFAC operand 89 
DESTID operand 89 
DESTRCV operand 90 
engueue lockout 90 

logically recoverable destinations 90 
physically recoverable destinations 90 
REUSE operand 91 
RSL operand 91 
TRANSID operand 91 
trigger level 92 
TRIGLEV operand 91 
TYPE=INTRA operand 89 
DFHDCT TYPE=REMOTE 92 
DESTID operand 92 
LENGTH operand 93 
RMTNAME operand 93 
SYSIDNT operand 92 
TYPB=REMOTB operand 92 
DFHDCT TYPE=SDSCI 93 
BLKSIZE operand 94 
BUFNO operand 94 
CTLCHR operand 96 

data set control information, DFHDCT 
TYPE=SDSCI 93 
DEVADDR operand 96 
DEVICE operand 96 
DSCNAME operand 94 
ERROPT operand 94 
FILABL operand 96 
MODNAME operand 96 
RECFORM operand 94 
RECSIZE operand 94 
REWIND operand 95 
SUFFIX operand 95 
TPMARK=NO operand 96 


DFHDCT TYPE=SDSCI (continued) 

TYPE=SDSCI operand 93 
TYPEFLE operand 95 
variable length records 94 
DFHDLDBD TYPE=ENTRY 349 
DBD operand 350 
DFHDLDBD TYPE=FINAL 3 50 
DFHDLDBD TYPE=INITIAL 349 
DLI operand 349 
SUFFIX operand 349 
DFHDLPSB TYPE=ENTRY 348 
MXSSASZ operand 348 
PSB operand 348 
RMTNAME operand 349 
SYSIDNT operand 349 
DFHDLPSB TYPE=FINAL 349 
DFHDLPSB TYPE=INITIAL 348 
DLI operand 348 
SUFFIX operand 348 
DFHFCT 101 

configurator 102 
control section, DFHFCT 
TYPE=INITIAL 103 

data sets, DFHFCT TYPE=DATASET 105 
end of file control table, DFHFCT 
TYPE=FINAL 132 
examples 132 
file management 101 
header of segmented record, DFHFCT 
TYPE=SEGHEAD 128 
last segment set, DFHFCT 
TYPE=SEGLAST 129 

remote files, DFHFCT TYPE=REM0TB 126 
reusable VSAM data sets, 

SERVREQ=REUSE 109 

segment sets, DFHFCT TYPE=SBGSET 129 
segments of segmented record, DFHFCT 
TYPE=SEGDEF 127 

superset ISAM logic module, DFHFCT 
TYPE=LOGICMOD 125 
VSAM alternate index example 135 
VSAM ICIP mixed mode access, DFHFCT 
TYPE=ALTERNATE 103 
VSAM shared resources control, DFHFCT 
TYPE=SHRCTL 130 
DFHFCT TYPE=ALTERNATE 103 
ACCMETH operand 104 
BUFND operand 105 
BUFNI operand 105 
DATA operand 105 
DATASET operand 104 
INDEX operand 105 
JID operand 105 
JREQ operand 105 
LOG operand 105 
PASSED operand 105 
RECFORM operand 105 
SERVREQ operand 104 
STRNO operand 105 
STRNOG operand 105 
TYPE=ALTERNATE operand 104 
DFHFCT TYPE=DATASBT 105 
ACCMETH operand 107 
alternate index structure 120 
automatic logging to system log 115 
BASE operand 120 
BLKKEYL operand 110 
BLKSIZE operand 111 
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DFHFCT TYPE =DATASET (continued) 
blocking factor 120 
BUFND operand 111 
BUFNI operand 111 
BUFSP operand 112 
cylinder index area 113 
cylinder overflow records 119 
CYLOFL operand 119 
DATA operand 121 
DATASET operand 107 
DEVICE operand 119 
EXTENT operand 120 
file service requests 108 
FILSTAT operand 112 
format of records 116 
INDAREA operand 113 
INDEX operand 121 
index skip feature 120 
INDSIZE operand 113 
INDSKIP=YES operand 120 
IOSIZE operand 113 
IOWORK operand 121 
JID operand 113 

journal file identification 113 
journaling requests 114 
JREQ operand 114 
key field 118 
KEYLEN operand 115 
LOG operand 115 
logical key length 115 
logical record length 116 
LRECL operand 116 
master index, ISAM data sets 120 
maximum number of extents 120 
mixed mode files (VSAM ICIP) 121 
MODE operand 121 
MSTIND=YES operand 120 
multiple track search 118 
NRECDS operand 120 
OPEN operand 116 
parity check 119 
PASSWD operand 116 
physical key length 110 
RECFORM operand 116 
relative addressing 117 
RELTYPE operand 117 
RKP operand 118 
RSL operand 118 
SERVREQ operand 108 
SRCHM operand 118 
strings 119 
strings (GET only) 122 
STRNO operand 119 
STRNOG operand 122 
TYPE=DATASET operand 107 
VERIFY=YES operand 119 
VSAM buffers 111 
DFHFCT TYPE=FINAL 132 
DFHFCT TYPE=INDACC 123 
ARGTYP operand 123 
argument type 123 

cross—index data set record, DFHFCT 
TYPE=INDACC 123 
deblocking technique 124 
DUPDSID operand 124 
duplicate data set 124 
IADADMI operand 124 
IADIII operand 124 


DFHFCT TYPE=INDACC (continued) 
IALKFL operand 123 
IARLKP operand 123 
OBJDSID operand 123 
object data set 123 
record identification field 123 
search argument type 124 
SRCHTYP operand 124 
TYPE=INDACC operand 123 
DFHFCT TYPE-INITIAL 103 
SUFFIX operand 103 
TYPE=INITIAL operand 103 
DFHFCT TYPE=LOGICMOD 125 

rotational position sensing 125 
RPS= SVA operand 125 
TYPE=LOGICMOD operand 125 
DFHFCT TYPE=REMOTE 126 
DATASET operand 126 
KEYLEN operand 126 
LRECL operand 126 
RMTNAME operand 126 
SYSIDNT operand 126 
TYPE=REMOTE operand 126 
DFHFCT TYPE=SEGDEF 127 
SEGCHAR operand 127 
SEGLENG operand 127 
segment characteristics 127 
segment length 127 
SEGNAME operand 127 
TYPE=SEGDEF operand 127 
DFHFCT TYPB=SEGHEAD 128 
INDDISP operand 128 
SEGLENG operand 128 
segment indicator field 128 
TSEGIND operand 128 
TYPE“SEGHEAD operand 128 
DFHFCT TYPE=SEGLAST 129 

TYPE=SEGLAST operand 129 
DFHFCT TYPE=SEGSET 129 
SEGNAME operand 130 
SEGSET operand 130 
TYPE=SEGSET operand 129 
DFHFCT TYPB=SHRCTL 130 
BUFFERS operand 131 
KEYLEN operand 131 
maximum key length 131 
resource limit 131 
RSCLMT operand 131 
STRNO operand 131 
TYPE=SHRCTL operand 131 
DFHJC TYPB= (GETJCA,0PEN) 453 
DFHJC TYPE=CLOSE 438 
IDERROR operand 438 
10ERROR operand 438 
JFILEID operand 439 
LEAVE operand 439 
NORESP operand 439 
STATERR operand 439 
TYPE=CLOSE operand 438 
DFHJC TYPE=GET 439 

EOFADDR operand 441 
IDERROR operand 441 
INVREQ operand 441 
IOERROR operand 441 
JFILEID operand 441 
NORESP operand 441 
NOTOPEN operand 441 
STATERR operand 441 
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DFHJC TYPE=GET (continued) 

TYPE=GETB/GETF/NOTE/POINT operand 440 
VOLERR operand 441 
DFHJC TYPE=OPEN 435 
IDERROR operand 436 
INVREQ operand 436 
IOERROR operand 436 
JFILEID operand 436 
NORESP operand 436 
SIVOL=YES operand 436 
STATERR operand 437 
TYPB=OPEN operand 436 
VOLERR operand 437 
volume error 437 
VOLUME operand 437 
DFHJCT 136 

control section, DFHJCT 
TYPE=INITIAL 136 

end of journal control table, DFHJCT 
TYPE=FINAL 140 
example 140 

journal entries, DFHJCT TYPE=ENTRY 137 
DFHJCT TYPE=ENTRY 137 

buffer shift—up value 138 
BUFSIZE operand 137 
BUFSUV operand 138 
DEVADDR operand 139 
FORMAT=SMF operand 138 
JDEVICE operand 140 
JFILEID operand 137 
journal file identification 137 
journaling options 138 
JODROPT operand 138 
JTYPE operand 138 
OPEN operand 139 
RSL operand 139 
SYSWAIT operand 139 
type of journal data set 138 
TYPE=ENTRY operand 137 
volume switching 138 
DFHJCT TYPE=FINAL 140 
DFHJCT TYPE=INITIAL 136 
SUFFIX operand 137 
TYPE=INITIAL operand 137 
DFHKP TYPE=CHECK 

EOFADDR operand 474 
IOERROR operand 474 
NORESP operand 474 

test transaction backout response 473 
TYPE^CHECK operand 474 
DFHKP TYPE=RTBOCTL 

EOFADDR operand 472 
IOERROR operand 472 
NORESP operand 472 
read transaction backout control 
record 472 

TYPE=RTBOCTL operand 472 
DFHKP TYPE=RTBODATA 

EOFADDR operand 473 
IOERROR operand 473 
NORESP operand 473 
read transaction backout data 473 
TYPE=RTBODATA operand 473 
DFHKP TYPE=RTBOEND 

reset transaction backout pointer 473 
TYPE=RTBOEND operand 473 
DFHMCT 141 


DFHMCT (continued) 

control section, DFHMCT 
TYPE=INITIAL 142 

end of monitoring control table, DFHMCT 
TYPE=FINAL 146 
DFHMCT TYPE=EMP 

ACCOUNT operand 143 
CLASS operand 142 

event monitoring points (BMPs) 142 
ID operand 143 
PERFORM operand 143 
TYPE=EMP operand 142 
DFHMCT TYPS=FINAL 146 
DFHMCT TYPB=INITIAL 142 
EVENT operand 142 
SUFFIX operand 142 
TYPE=INITIAL operand 142 
DFHMCT TYPE=RECORD 
CLASS operand 145 
CONV=YES operand 145 
CPU operand 145 
DATASET operand 145 
FREQ operand 145 
MAXBUF operand 145 
TYPE=RECORD operand 144 
DFHNET DSECT 412 
DFHNLT 146 

control section, DFHNLT 
TYPE=I»ITIAL 151 
default load order 147 
end of nucleus load table, DFHNLT 
TYPE=FINAL 156 
examples 156 

module load sequence, DFHNLT 
TYPE=ENTRY 151 
trace table alignment 157 
DFHNLT TYPE=ENTRY 151 
ADRSPCB operand 153 
ALIGN operand 152 
FIX operand 153 
MODULE operand 152 
nucleus module name 152 
page alignment 152 
page fixing 153 
PAGEIN operand 153 
PAGEOUT operand 154 
PROTECT operand 154 
SHR operand 155 
TYPE=ENTRY operand 152 
DFHNLT TYPE=FINAL 156 
DFHNLT TYPE=INITIAL 151 
SHR operand 151 
SUFFIX operand 151 
TYPE=INITIAL operand 151 
DFHOC TYPE=CLOSB 603 
DATASET operand 603 
DSETID operand 603 
TYPE=CLOSE operand 603 
DFHOC TYPE=0PEN 599 
CHECK operand 600 
DATASET operand 599 
destination identification 600 
DSETID operand 600 
ICIP and mixed mode files 602 
LISTADR operand 601 
MODE operand 602 
SYMBADR operand 603 
TYPE=OPEN operand 599 
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0 


!)FHOC TYPE=SWITCH 

DATASET=DUMP operand 604 
TYPB=SWITCH operand 604 
5FHPC TYPE=SETXIT macro 419 
1FHPCT 159 

control section, DFHPCT 
TYPE=INITIAL 160 

end of program control table, DFHPCT 
TYPE=FINAL 185 
examples 185 
remote transactions 182 
required entries 695 
summary 693 

session processing options (LUTYPE6), 
DFHPCT TYPE=PROFILE 181 
special entries 

DFHPCT TYPB=GROUP 176 
transaction control information, DFHPCT 
TYPE=ENTRY 162 

transaction description options, DFHPCT 
TYPE=OPTGRP 179 
TWASIZE 694 

>FHPCT TYPE=ENTRY 162,171 
anticipatory paging 165 
ANTICPG operand 165 
automatic journaling 
logical units 171 
storing records 170 
CLASS operand 166 
COMPAT operand 167 
deadlock time-out feature 168 
T>TTl 1A7 

DT1MOUT operana ib« 

DUMP operand 168 

DVSUPRT operand 168 

dynamic transaction backout 167 

EXTRACT operand 169 

EXTSEC operand 169 

FDUMP operand 169 

INBFMH operand 170 

JFILEID operand 170 

logical record presentation 170 

LOGREC operand 170 

message option group 171 

MSGJRNL operand 171 

NEPCLAS operand 171 

OPTGRP operand 171 

primed storage allocation 175 

PRIVATE operand 171 

PRMSIZE operand 175 

PROGRAM operand 163 

RAQ operand 171 

read time-out feature 172 

RESTART operand 172 

RSL operand 172 

RSLC operand 172 

RTIMOUT operand 172 

SCRNSZE operand 173 

SPURGE operand 174 

system stall purge indicator 174 

TASKREQ operand 164 

TCLASS operand 174 

terminal error purge indicator 174 

TPURGE operand 174 

transaction class 174 

transaction priority 175 

transaction restart facility 172 

transaction security key 174 


DFHPCT TYPB=ENTRY (continued) 

transaction work area size 175 
TRANSEC operand 174 
TRANSID operand 164 
TRNPRTY operand 175 
TRNSTAT operand 175 
TWASIZE operand 175 
TYPE=ENTRY operand 163 
XTRANID operand 175 
DFHPCT TYPE=FINAL 185 
DFHPCT TYPE=GROUP 176 
EXTSEC operand 179 
FN operand 176 
functional groups 176 
KEYID operand 179 
required entries 693 
TYPE=GROUP operand 176 
DFHPCT TYPB=INITIAL 160 
DTB operand 160 

dynamic transaction backout 160 
EXTSEC operand 161 
FDUMP operand 161 
formatted dump program 161 
INDEX operand 161 
indexing 161 
SCRNSZE operand 161 
SUFFIX operand 160,162 
TRANSEC operand 162 
TYPE=INITIAL operand 160 
DFHPCT TYPE=OPTGRP 179 
message integrity 180 
message option groups 179 
orotection 180 


nsGPOPr operand 

180 

MSGPREQ operand 

180 

TYPE=OPTGRP operand 180 

DFHPCT TYPE=PROFILE 

181 „ 

automatic journaling 

logical units 

182 

EXTRACT operand 

181 

INBFMH operand 

181 

JFILEID operand 

182 

MSGJRNL operand 

182 

NEPCLAS operand 

182 

DFHPCT TYPE-REMOTE 

182 

LOCALQ operand 

183 

RMTNAME operand 

183 

SYSIDNT operand 

183 

TYPE=REKOTE operand 183 

XTRANID operand 

185 

DFHPCT TYPB=SYSTEM 


DATASTR operand 

294 

DFHPLT 188 


control section. 

DFHPLT 


TYPE=INITIAL 190 
end of program list table, DFHPLT 
TYPE=FINAL 191 

entries in program list table, DFHPLT 
TYPE=ENTRY 190 
example 191 

first quiesce stage 189 
post—initialization phase 189 
system initialization processing 188 
DFHPLT TYPE=BNTRY 190 
PROGRAM operand 190 
PROGRAM=DFHDELIM operand 191 
PROGRiM=DLZSTP00 operand 191 
TYPE=ENTRY operand 190 
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DFHPLT TYPE=FINAL 191 
DFHPLT TYPE=INXTIAL 190 
SUFFIX operand 190 
TYPE=I NITIAL operand 190 
DFHPPT 192 

control section — DFBPPT 
TYPE=INITIAL 192 

end of processing program table, DFHPPT 
TYPE=FINAL 200 
example 200 

processing programs, DFHPPT 
TYPE=ENTRY 193 
required entries 
summary 695 
special entries 

DFHPPT TYPE=GROUP 196 
DFHPPT TYPE=ENTRY 193 

BMS device—dependent mapsets 193 
forced pageout 195 
mapset suffixes 193 
PGMLANG operand 193 
PGMSTAT operand 194 
program load request 194 
PROGRAM operand 193 
RELOAD operand 194 
RES operand 195 
RSL operand 196 
TYPE=ENTRY operand 193 
USAGE=MAP operand 196 
use count for BMS maps 196 
DFHPPT TYPE=FINAL 200 
DFHPPT TYPE=GROUP 196 

execution diagnostic facility (EDF) 19S 

FN operand 197 
functional groups 197 
required entries 695 
TYPE=GROUP operand 197 
DFHPPT TYPE=INITIAL 192 
INDEX operand 193 
SUFFIX operand 193 
TYPE=INITIAL operand 193 
DFHSG 13 

PROGRAM=ATP 24 
PROGRAM=BFP 24 
PROGRAM=BMS 25 
PROGRAM=CSA 34 
PROGRAM=CSD 34 
PROGRAM=CSO 35 
PROGRAM=CSS 38 
PROGRAM=CSU 38 
P£OGRAM=DBP 39 
PROGRAM=DCP 39 
PROGRAM=DIP 40 
PROGRAM=EIP 40 
PROGRAM=EXP 41 
PROGRAM=FCP 43 
PROGRAM=GAP 44 
PROGRAM=HLL 45 
PROGRAM=ICP 46 
PROGRAM=ISC 46 
PROGRAM=JCP 48 
PROGRAM=KCP 49 
PROGRAM=KPP 50 
PROGRAH=HTP 51 
PROGRAM=OCP 52 
PROGRAM=PCP 52 
PROGRAM=PREGEN 53 
PROGRAM=SCP 53 


DFHSG (continued) 

PROGRAM=SRP 54 
PROGRAM=TBP 55 
PROGRAtt=TCP 55 
PROGRAH=TDP 69 
PROGRAH=TRP 70 
PROGRAH=TSP 71 
TYPE=FINAL 72 
TYPE =INITIAL 14 
DFHSG PROGRAM=ATP 24 

PROGRAM=ATP operand 24 
STAGE2 operand 24 
DFHSG PR0GRAM=3FP 24 
basic function 24 
BUILTIN operand 25 
DUNMY=YES operand 25 
PROGRAH=BFP operand 25 
STAGE2 operand 25 
SUFFIX operand 25 
weighted retrieval function 24 
DFHSG PROGRAM=BMS 25 

BMS page building routines 30 

BMSCPYC operand 27 

BMSDDS operand 27 

BMSDEV operand 27 

BMSDIAG operand 29 

BMSDRT operand 29 

BMSFMP operand 29 

BMSFRL operand 30 

BMSMBD operand 30 

BMSNL operand 30 

BMSPB operand 30 

BMSPGO operand 30 

BMSPRG operand 31 

BMSPROP operand 31 

BMSRCVR operand 31 

BMSSMI operand 31 

BMSTAB operand 32 

BMSTXB operand 32 

COMPAT operand 32 

device—dependent mapset suffixes 27 
diagnostics 29 
DUMMY=YES operand 27 
field relocation 30 
MAPALGN operand 32 
MAPHC operand 33 
MAP3270 operand 32 
pageout routines 30 
PAGING operand 33 
PROGRAM=BMS operand 27 
purge delay time interval 218 
purge routines 31 
ROUTING operand 34 
single keystroke retrieval 34 
SKR3270 operand 34 
SUFFIX operand 27 
text building routines 32 
DFHSG PROGRAM=BSM 

PRGDLAY operand 218 
DFHSG PROGRAM=CSA 34 

PROGRAM=CSA operand 34 
SUFFIX operand 34 
DFHSG PROGRAM=CSD 34 

PROGRAM=CSD operand 35 
STAGE2 operand 35 
DFHSG PROGRAM=CSO 35 

appendage routine, 7770 37 

automatic statistics 36 
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HSG PROGRAM=CSO (continued) 

CAA operand 37 

monitoring programs (DFHCMP, DFHCMON 
DFHCCMF) 35 
PROGRAM=CSO operand 37 
STAGE2 operand 37 
TCAMSIP=YES operand 37 
version 1 compatibility 37 


V1CMPAT=YES operand 

37 

HSG PROGRAM=CSS 

38 


PROGRAM=CSS operand 

38 

STAGB2 operand 

38 


HSG PROGRAM=CSU 

38 


automatic statistics 

38 

PROGHAH=CStJ operand 

39 

SFAGE2 operand 

39 


HSG PROGRAM=DBP 

39 


DLI operand 39 



PROGRAM=DBP operand 

39 

SPAGE2 operand 

39 


SUFFIX operand 

39 


HSG PROGRAM=DCP 

39 


DEVADDB operand 

40 


DEVICE operand 

40 



DUMMY=YES operand 40 
PROGRAM=DCP operand 40 
STAGE2 operand 40 
SUFFIX operand 40 
HSG PROGRAM=DIP 40 
DUMMY=YES operand 40 
PROGRAM=DIP operand 40 
STAGE2 operand 40 
SUFFIX operand 40 
HSG PROGRAM=EIP 40 
PROGRAM=EIP operand 41 
SIAGB2 operand 41 
HSG PROGRAM=EXP 41 
DLI/DL1 operand 42 
LANG operand 42 
PLI/PL1=SHARE operand 42 
PLILIB operand 43 
PROGRAM=EXP operand 42 
STAGE2 operand 42 
SUFFIX operand 42 
HSG PROGRAM=FCP 43 
AUIOJRN operand 44 
automatic journaling 44 
DUMMY=YES operand 43 
FILSERV operand 43 
PROGRAM=FCP operand 43 
SUFFIX operand 43 
•HSG PROGRAM=GAP 44 
PROGRAM=GAP operand 45 
STAGB2 operand 45 
HSG PROGRAM=HLL 45 
LANG operand 45 
PLILIB operand 46 
PL1/PLI operand 46 
PROGRAM-HLL operand 45 
STAGB2 operand 45 
“HSG PROGRAM—ICP 46 
PROGRAM=ICP operand 46 
STAGE2 operand 46 
SUFFIX operand 46 
‘HSG PROGRAM=ISC 46 
DL/I shared data base support 47 
DOMMY=YES operand 48 
PROGRAB=ISC operand 48 


DFHSG PROGRAM=ISC (continued) 
SUFFIX operand 48 
DFHSG PROGSAM=JCP 48 
AUTOJRN operand 48 
automatic journaling 48 
automatic logging 49 
DTB operand 49 
DUMMY=YES operand 48 
NOTE operand 49 
positioning information 49 
PROGRAM=JCP operand 48 
STAGE2 operand 48 
SUFFIX operand 48 
DFHSG PROGRAM=KCP 49 
DFHSG PROGRAM=KPP N 50 

activity fceypointing 50 
AKP operand 50 

block size, restart data set 51 
DEVICE operand 51 
DUMMY=YES operand 50 


PROGRAM=KPP operand 

50 

RSDBLKS operand 

51 


STAGE2 operand 

50 


SUFFIX operand 

50 


DFHSG PROGRAM=MTP 

51 


PROGRAH=HTP operand 

52 

STAGE2 operand 

52 


DFHSG PROGRAM=0CP 

52 


PROGRAM-OCP operand 

52 

STAGE2 operand 

52 


DFHSG PROGRAM=PCP 

52 


ANS COBOL compilers 

52 

COBOL compilers 

52 


COBOL operand 

52 


hign—level language 

trace 

HLLTR operand 

53 


LAKG operand 53 
PROGRAH=PCP operand 

52 

SUFFIX operand 

52 


DFHSG PROGSAM=SCP 

53 


PROGRAM=SCP operand 

54 

RECOVER operand 

54 


STAGE2 operand 

54 



storage recovery 54 
SUFFIX operand 54 
DFHSG PROGBAM=SRP 54 
DUMMY=YBS operand 55 
PROGRAM=SRP operand 55 
STAGE2 operand 55 
SUFFIX operand 55 
DFHSG PROGRAM=TBP 55 
DLI operand 55 
PROGRAM=TBP operand 55 
STAGE2 operand 55 
DFHSG PROGRAM=TCP 55 
ACCMETH operand 57 
ANSWRBK operand 58 
automatic transaction initiation 
AUTOTRN operand 59 
BSCODE operand 59 
BTAM device types 59 
BTAMDEV operand 59 
chain assembly 61 
CHNASSY operand 61 
CMPT60L operand 62 
COMPAT operand 62 
CONVTAB operand 63 
DEVICE operand 63 


59 
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DFHSG PROGRAM^TCP (continued) 

DL/I shared data base support 57 
end—of-data indicator 63 
EODI=xx operand 63 
FEATURE operand 64 
FMT2260 operand 64 
FMT3270 operand 64 
IS1TRL=YES operand 68 
keyboard lock feature 65 
LOCKF=YES operand 65 
logical record presentation 65 
logical unit types 67 
LOGREC operand 65 
pipeline session 65 
PIPELN operand 65 
PROGRAM=TCP operand 57 
PUNSOL operand 65 
SMI operand 66 
STAGE2 operand 57 
SUFFIX operand 57 
TAB operand 66 
TBLFIX operand 66 
TCM3270=YES operand 68 
translate tables 66 
TWXOFF operand 66 
TWXON operand 66 
UCTRAN operand 66 
unsolicited input 65 
uppercase translation 66 
VTAMDEV operand 67 
WRAPLST operand 68 
2260 compatibility 62 
DFHSG PROGRAM-TDP 69 

DAM/BDAM intrapartition gueues 69 
DESTRCV operand 69 
DUMMY=YSS operand 69 
EXTRA operand 69 
extrapartition data sets 69 
INTRA operand 69 
intrapartition data sets 69 
PROGRAM=TDP operand 69 
recoverable destinations 69 
STAGE2 operand 69 
SUFFIX operand 69 
transient data recovery 69 
VSAM intrapartition gueues 69 
DFHSG PROGRAM=TRP 70 
AUX operand 70 
DEVADDR operand 71 
DEVICE operand 71 
DUMMY=YES operand 70 
PROGRAM=TRP operand 70 
STAGE2 operand 70 
SUFFIX operand 70 
DFHSG PROGSAM=TSP 71 
AUX operand 71 
auxiliary storage 71 
DUMMY=YSS operand 71 
PROGRAM=TSP operand 71 
STAGE2 operand 71 
SUFFIX operand 71 
DFHSG TYPE=FINAL 72 
DFHSG TYPE=INITIAL 14 
ACCTID operand 16 
anticipatory paging SVC 21 
ASMBLR operand 16 
CICSSVC operand 21 
CLASS operand 22 


DFHSG TYPE^INITIAL (continued) 

CONDCD operand 22 
DEBCHK operand 21 
DEVICE operand 20 
DLI operand 16 
EJECT operand 17 
JOBNAME operand 17 
MOD operand 17 
MSGCLAS operand 22 
MSGLVL operand 22 
OPSYS operand 18 
OS/VS JCL options 22 
page—fix SVC 21 
PGMERID operand 22 
PREFIX operand 23 
PRINT operand 18 
PRIORTY operand 23 
PROCNMS operand 23 
REGION operand 23 
service reguest block SVC 21 
SEBSVC operand 21 
STAGE2 operand 19 
STARTER operand 20 
starter system library 19 
STATUS=FIRST operand 21 
TCTUA operand 22 
TYPE=INITIAL operand 15 
Version 1 compatibility 22 
VSAM operand 20 
VSAM shared resources 20 
VSAMSKR operand 20 
VTAM operand 20 
DFHSIT 201 

ABKPOPT operand 205 
activity keypoint frequency 205 
AKPFREQ operand 205 
ALT operand 205 
AMXT operand 206 
APPLID operand 206 
ATP operand 207 
ATPINS operand 207 
ATPMB operand 207 
ATPMT operand 207 
ATPOUTS operand 207 
BMS operand 207,208 
buffer pool size 225 
BUFPL operand 225 
CMP operand 208 
CMXT operand 208 
CSA operand 208 
data management block (DMB) pool 
size 226 

DATFORM operand 209 
DBP operand 209 
DBUFSZ operand 209 
DCP operand 209 
DCT operand 210 
DDIR operand 225 
DIP operand 210 

DL/I shared data base support 206,227 

DLI operand 210 

DLTHRED operand 226 

DMBPL operand 226 

DSB operand 210 

dynamic buffer size 209 

dynamic transaction backout 209 

BNQ control block space 226 

ENQPL operand 226 
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>FHSIT (continued) 

EXEC operand 210 
EXITS=YES operand 210 
EXTSEC operand 211 
FCP operand 211 
FCT operand 211 
FDP operand 211 
FEES operand 224 
FLDSEP operand 212 
FIDSTRT operand 212 
formatted dump program 211 
F2260 operand 211 
ICP operand 213 
ICV operand 213 
ICVR operand 214 
ICVS operand 214 
ICVSWT operand 225 
ICVTSD operand 214 
IIP operand 214 
IOCP operand 226 
IRCSTRT operand 214 
ISC operand 214 
JCP operand 214 
JCT operand 215 
KCP operand 215 
keypointing with abnormal 
termination 205 
KPP operand 215 
LPA operand 226 

maximum number of active asynchronous 
tasks 207 

maximum number of active tasks 206 

MCP operand 215 

MCT operand 215 

MONITOR operand 215 

MSGLVL operand 215 

MXT operand 216 

M32 operand 215 

NLT operand 216 

NSD operand 225 

OSCOR operand 227 

page-chaining command 216 

page-copy command 217 

page—purge command 217 

PBP operand 216 

PCP operand 216 

PCT operand 216 

PDIR operand 229 

PGCHAIN operand 216 

PGCOPY operand 217 

PGPURGE operand 217 

PGRET operand 217 

PGSIZE operand 217 

PISCHD operand 229 

PLI operand 217 

PLISHRE operand 229 

PLTPI operand 218 

PLTSD operand 218 

PPT operand 218 

PRINT operand 219 

PSB operand 230 

PSB pool size 230 

PSBPL operand 230 

RLE operand 220 

SCP operand 220 

SCS operand 220 

SIMODS operand 220 

SKR operand 221 


DFHSIT (continued) 

SRP operand 221 
SET operand 221 
START operand 221 
storage cushion size 220 
storage violation dump 222 
SOFFIX operand 204 
SVD operand 222 
TCP operand 222 
TCT operand 222 
TOP operand 222 
TPP operand 222 
trace table entries 223 
TRP operand 222 
TRT operand 223 
TSMGSET operand 223 
TSP operand 223 
TST operand 223 
TYPE=CSECT/DSECT operand 205 
WRKAREA operand 223 
XLT operand 224 
XPS3 operand 230 
XSP operand 224 
XTP operand 224 
XTRAN operand 230 
ZCP operand 224 
DFHSNEP TYPE=DEFILU 

TYPE=DEFILU operand 407 
DFHSNEP TYPE=DEF3270 

TYPE=DEF3270 operand 406 
DFHSNEP TYPE=ERRPROC 410 
CODE operand 411 
GROOP operand 411 
TYPE=ERKPROC operand 410 
DFHSNEP TYPE=FINAL 407 
DFHSNEP TYPE^INITIAL 406 
CS=NO operand 406 
NAME operand 406 
NETNAME operand 406 
TYPE=INITIAL operand 406 
DFHSNET macro 407 
COUNT operand 407 
ESB structure 408 
ESBS operand 408 
NAME operand 407 
NEBNAME operand 408 
NEBS operand 408 
TIME operand 408 
DFHSNT 230 

control section, DFHSNT 
TYPE=INITIAL 231 
DFHSNT TYPE=FINAL 235 
example 235 
sign-on procedure 230 
terminal operators, DFHSNT 
TYPB=BNTRY 232 
3741 sign—on 543 
DFHSNT TYPE=ENTRY 232 
EXTSEC operand 232 
NAMFORM=DEC operand 233 
OPCLASS operand 233 
OPIDENT operand 232 
OPNANE operand 232 
OPPRTY operand 233 
PASSWRD operand 233 
RSLKEY operand 234 
SCTYKEY operand 234 
TYPE=ENTRY operand 232 
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DFHSNT TYPE-FINAL 235 
DFHSNT TYPE=INITIAL 231 
EXTSEC operand 231 
TYPE=INITIAL operand 231 
DFHSRT 236 

control section, DFHSRT 
TYPE=INITIAL 236 

end of system recovery table, DFHSRT 
TYPS=FINAL 238 
example 238 

specify system/user abend codes 236 
DFHSRT TYPE=FINAL 238 
DFHSRT TYPE=INITIAL 236 
SUFFIX operand 236 
TYPE=INITIAL operand 236 
DFHSRT TYPE=SYSTEM/USER 236 
ABCODE operand 237 
abend recovery 237 
operating system abend code 236 
OS/VS abend codes 237 
PROGRAM operand 237 
ROUTINE operand 237 
system abend code 236 
TiPE =S YSTEM/USER operand 236 
user-supplied abend code 236 
VSE abend codes 238 
DFHTACP 

default actions (TCAM) 520 

error messages and codes 753 
DFHTC CTYPE=CHECK 586 

CTYPE=CHECK operand 587 
ERROR operand 587 
INVADDR operand 587 
INVID operand 587 
INVLDC operand 587 
INVREQ operand 587 
LASTTRM operand 587 
NORESP operand 587 
DFHTC CTYPS=COMMAND 588 
ACF/VTAM indicators 487 
COMMAND operand 588 
CTYPE=COMMAND operand 588 
DFHTC CTYPE=LOCATE 579 

CTYPE=LOCATE operand 580 
DOMAIN operand 580 
ERROR operand 581 
find TCTTE 579 
INVADDR operand 581 
INVID operand 581 
LASTTRM operand 581 
LDC operand 581 
NETNAME operand 582 
NORESP operand 582 
retrieve LDC information 579 
scan TCT 579 
TERM operand 582 
XLATEID operand 583 
DFHTC CTYPE=STATUS 583 

CTYPE=STATUS operand 584 
ERROR operand 584 
INVADDR operand 584 
INVID operand 584 
INVLDC operand 584 
INVREQ operand 584 
LASTTRM operand 584 
LDC=YES operand 584 
logical units 502 
NORESP operand 584 


DFHTC CTYPE=STATUS (continued) 

STATUS operand 585 
TERM operand 586 
DFHTC macros 579 
DFHTCP, DFHZCP 486 
DFHTCT 239 

batch regions, DFHTCT TYPE=IRCBCH 259 
communication lines, DFHTCT 
TYPE=LINE 265 
configurator 240 
control section, DFHTCT 
TYPE=INITIAL 247 

data set control information, DFHTCT 
TYPE=SDSCI 281 

digital response messages for 7770 328 

end of terminal control table, DFHTCT 
TYPE=FINAL 329 
example 330,701 
intercommunication links 
DFHTCT TYPE=SYSTEM 292 
line group types 

DFHTCT TYPE=GPBNTRY 251 
local LDC list, DFHTCT TYPE=LDCLIST 264 
remote terminal entries 279 
system LDC table, extended local LDC 
list (DFHTCT T YPE=LDC) 259 
teletypewriter (WTC only) disconnect 
message 328 

teletypewriter (WTC only) station 
identification 327 
terminal types, DFHTCT 
TYPE=TERMINAL 297 
DFHTCT TYPE=FINAL 329 
DFHTCT TY?E=GPENTRY 251 

address of each terminal 256 

alternate screen size 253 

ALTSCRN operand 253 

ALTSFX operand 254 

block size 255 

control unit address 254 

CUADDR operand 254 

CUFEAT operand 254 

CUPOSN operand 254 

GPBLKSZ operand 255 

GPNAME operand 255 

GPNTRMS operand 255 

GPSBQLU operand 255 

GPTCU operand 255 

GTYPE operand 252 

line features 255 

LINELST operand 255 

LINFEAT operand 255 

LIN1NL operand 256 

number of terminals 255 

system logical unit number 255 

terminal control table user area 259 

terminal identification 257 

terminal input area length 256,257 

terminal line group type 252 

terminal model number 257 

transmission control unit 255 

TRMADDR operand 256 

TRMFEAT operand 256 

TRMIDNT operand 257 

TRBINL operand 257 

TRMMODL operand 257 

TRMPOSN operand 258 

TRMPRTY operand 258 
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DFHTCT TYPE=GPENTRY (continued) 

TRMSTAT operand 258 
TRMUAL operand 259 
TYPE=GPENTRY operand 252 
VSE file names 255 
DFHTCT TYPE=INITIAL 247 
ACCMETH operand 248 
APPLID operand 248 
ERRATT operand 248 
GMTEXT operand 249 
MODNAME operand 250 
OPNDLIM operand 249 
RAMAX operand 249 
RAMIN operand 249 
RAPOOL operand 250 
RATIMES operand 250 
RESP operand 250 
response type 250 
SUFFIX operand 248 
SYSIDNT operand 249 
TYPE=INITIAL operand 248 
DFHTCT TYPE=IRCBCH 259 

interregion communication 259 
SESNUMB operand 259 
TYPE=IRCBCH operand 259 
DFHTCT TYPE=ISLINK (see DFHTCT TYPE=SYSTEM) 
DFHTCT TYPE=LDC 259 

destination selection 261 
DSN operand 261 
DVC operand 261 
extended local LDC list 263 
LDC operand 261 
LOCAL operand 263 
paging activity 263 
PGESIZE operand 263 
TYPE=LDC operand 260 
DFHTCT TYPE=LDCLIST 264 
LDC operand 264 

logical device codes (LDCs) 264 
TYPE=LDCLIST operand 264 
DFHTCT TYPE=LINE 265 
ACCMETH operand 266 
answering list 274 
ANSWRBK operand 269 
automatic answering feature 272 
automatic calling feature 272 
automatic polling feature 272 
binary synchronous communication 
code 270 

BSCODE operand 270 

BTAM define—terminal—list macro 274 

BTAM—expanded ID verification 270 

BTAMRLN operand 270 

buffer receive feature 273 

CLASS operand 270 

CONVTAB operand 271 

data set control name 271 

device classification 270 

DSCNAME operand 271 

ERRATT operand 271 

ERRMSG operand 272 

FEATURE operand 272 

FSTTERM operand 273 

general poll 273 

GENPOLL=YES operand 273 

INAREAL operand 267 

input BSAM data set control name 273 
ISADSCN operand 273 


DFHTCT TYPE=LINE (continued) 

LINSTAT=*OUT OF SERVICE* operand 273 

LISTADR operand 274 

lock option 273 

message input area length 267 

negative poll delay 275 

NPDELAY operand 275 

OSADSCN operand 275 

output BSAM data set control name 275 
OUTQ operand 278 
pool of TCTLEs 278 
POOL =YES operand 278 
POOLADR operand 276 
POOLCNT operand 278 
process control information field 
(PCI) 276 

QUEUEID operand 279 
RDYMSG operand 276 
relative line number 270 
RVI (reverse interrupt) 267 
station control feature 273 
switched—line pools 265 
TCAM output process queue 278 
TCAM POOL feature 278 
TCAM process queue 279 
TCAMFET=SNA operand 279 
TCTUAL operand 276 
terminal control table line entry 
(TCTLE) 265 

terminal model number 276 
transmission code 271 
TRMMODL operand 276 
TRMTYPE operand 268 
TYPE=LINE operand 266 
VRC/LRC checking feature 273 
2260 screen format 277 
7770 ready message 276 
DFHTCT TYPB=REGION 

SYSIDNT operand 279 
TYPE=RBGION operand 279 
DFHTCT TYPE=REMOTE 279 
ACCMETH operand 281 
alternate page size 281 
alternate screen size 281 
ALTPGE operand 281 
ALTSCRN operand 281 
3MS features 281 
BMSFEAT operand 281 
default page size 281 
default screen size 281 
DEFSCEN operand 281 
FEATURE operand 281 
FF=YES operand 281 
HF operand 281 
LDC operand 281 

logical device codes (LDCs) 281 

PGESIZE operand 281 

SESTYPE operand 281 

station address 281 

STN2980 operand 281 

SYSIDNT operand 281 

TAB2980 operand 281 

terminal input/output area length 281 

TIOAL operand 281 

TRMIDNT operand 281 

TRMMODL operand 281 

TRMTYPE operand 281 

VF operand 281 
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DFHTCT TYPE=SDSCI 281 
appendage routine 289 
APPENDG operand 289 
autopoll feature 287 
binary synchronous line 
configuration 286 
binary synchronous transmission 
code 284 

BLKSIZE operand 284 
block size 284 
BSCODE operand 284 
BTAM device types 282 
CONFIG operand 286 
CU operand 287 

data definition (DD) statement 289 
data set control name 284 
DCB information 281 
DDNAME operand 289 
DEVADDR operand 287 
DEVICE operand 282 
DSCNAME operand 28 4 
DTF information 281 
EOM operand 284 
EOT operand 285 
ERROPT operand 285 
error recovery procedures 285 
FEATURE operand 287 
first communication line entry 290 
FLNNAME operand 290 
LBRBADR operand 286 
line connection 289 
line error recording block 286 
LINELST operand 288 
MACRF operand 290 
mode of communication 290 
MODE operand 290 
MODELS! operand 289 
MONDLY operand 286 
motor—on optional feature 286 
number of retries 289 
online terminal test facility 289 
online test facility 286 
OPTCD operand 290 
RECFM operand 291 
record format 291 
RETRY operand 289 
SWITCH operand 289 
SYNAD operand 291 
system/7, special features 287 
TCAM work unit 290 
TERMTST operand 289 
text—read errors 285 
text—write errors 286 
TYPE=SDSCI operand 282 
DFHTCT TYPE=SYSTEM 292 
ACCMETH operand 293 
INDSYS operand 294 
NETNAMB operand 294 
network name 294 
RECEIVE operand 295 
RECFM operand 295 
SEND operand 295 
SB STYPE operand 296 
SYSIDNT operand 294 
TIOAL operand 296 
TRMIDNT operand 296 
TRMSTAT operand 296 
TYPE=SYSTEM operand 293 


DFHTCT TYPE=SYSTEK (continued) 

XSNAM operand 297 
DFHTCT TYPB=TERMINAL 297 
ACCMETH operand 302 
alternate map suffixes 304 
alternate page size 302 
alternate screen size 303 
alternative printer 303 
ALTPGE operand 302 
ALTPRT operand 319 
ALTSCRN operand 303 
ALTSFX operand 304 
audible alarm feature 310 
automatic logon 309 
BMS features 304 
BMSFEAT operand 304 
BRACKET operand 305 
bracket protocol 305 
BTAM DFTRMLST macro 323 
BTAM print feature (3270) 311 

BTAM terminal address 323 
buffer expansion feature 311 
BUFFER operand 305 
buffer sizes 305 
chain assembly 307 
CHNASSY operand 307 
CLASS operand 307 
COMPAT operand 308 
C0NNECT=AUT0 operand 309 
CONSLID operand 327 
default page size 316 
default screen size 309 
DEFSCRN operand 309 
device classification 307 
DISMSG operand 309 
ERRATT operand 310 
extended color feature (3270) 311 

extended data stream support (3270) 311 

extended highlight feature (3270) 311 

FEATURE operand 310 
FF=YES operand 313 
generate logical units 301 
GMMSG operand 313 
HF operand 314 
INPUT status 325 
INTLOG status 325 
IPL status, system/7 326 
LASTTRM operand 314 
LDC operand 314 
local video unit 315 
logical device codes (LDCs) 314 
logical units/session types 300 
LOGMODE operand 315 
LPLEN operand 315 
LVUNIT operand 315 
NETNAME operand 315 
NETNAMQ operand 315 
network name 315 
NOINTLOG status 325 
number of concurrent tasks 321 
operator identification code 315 
operator priority 316 
operator security key 316 
OPERID operand 315 
OPERPRI operand 316 
OPERRSL operand 316 
OPERSEC operand 316 
OUT OF SERVICE status 326 
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'FHTCT TYPE=TERMINAL (continued) 
paging activity 318 
PGESIZE operand 316 
PGESTAT operand 318 
pipeline session 318 
PIPELN operand 318 
polling position 318 
POLLPOS operand 318 
primary printer 319 
print line length 315 
PRINTTO operand 319 
process control information field 
(PCI) 321 

DECEIVE status 326 
release logical unit 319 
RELBEQ operand 319 
reguest unit 319 
RUSIZE operand 319 
screen format, 2260 324 

selector pen feature 312 
SESTYPE operand 300,319 
station address 320 
STN2980 operand 320 
SYSIDNT operand 321 
TAB2980 operand 321 
TASKNO operand 321 
TCTOAL operand 321 

terminal control table terminal entry 
(TCTTE) 297 

terminal input/output area length 321 
terminal status 325 
TIOAL operand 321 
transaction code 322 
TRANSACTION status 325 
TRANSCEIVE status 326 
TEANSID operand 322 
TRMADDR operand 323 
TRMIDNT operand 300 
TRMMODL operand 323 
TRMPRTY operand 325 
TRMSTAT operand 325 
TBMTYPE operand 300 
TYPS=TERMINAL operand 300 
uppercase translation 312 
validation attributes (3270) 312 

VP operand 326 
VTAM SIMLOGON 309 
2260 compatibility 308 
3270 copy feature 311 
3270 printer selection 319 
3270 printer-adapter feature 312 
DFHTCT TYPE=TLXID 327 
LASTID operand 328 
TLXID operand 327 
TYPE=TLXID operand 327 
DFHTCT TYPE=TLXMSG 328 
TLXMSG operand 328 
TYPE=TLXMSG operand 328 
DFHTCT TYPE=77708SG 328 

digital response messages 329 
MESSAGE operand 329 
TYPE=7770MSG operand 329 
DFHTEP 

alternate interface (CICS/OS/VS 
only) 39 5 

recursive retry routine 393 
DFHTEPM macro examples 379 
DFHTEPM TYPE=ENTRY 378 


DFHTEPM TYPE=ERBPROC 378 
CODE operand 379 
TIPE=EEEPEOC operand 379 
DFHTEPM TYPE=EXIT 378 
DFHTEPM TYPE=FINAL 379 
DFHTEPM TYPE=INITIAL 
DSECTPE operand 375 
OPTIONS operand 375 
PRINT operand 376 
TYPE=INIT1AL operand 374 
DFHTEPT macro examples 386 
DFHTEPT TYPE=BUCKET 385 
CODE operand 385 
TYPE=BDCKBT operand 385 
DFHTEPT TYPE=FINAL 386 
DFHTEPT TYPE=INITIAL 381 
MAXBRRS operand 381 
MAXTIDS operand 381 
OPTIONS operand 382 
TYPE=INITIAL operand 381 
DFHTEPT TYPE=PEEMCODE/ERECODE 382 
CODE operand 383 
COUNT operand 383 
TIME operand 384 
DFHTEPT TXPE=PERMTID 382 
TEMIDNT operand 382 
TYPE=PEEMTID operand 382 
DFHTLT 332 

control section, DFHTLT 
TYPE=INITIAL 333 
end of terminal list table, DFHTLT 
TYPE=FINAL 334 

entries in terminal list table, DFHTLT 
TYPE=ENTRY 333 
example 334 
message switching 332 
DFHTLT TYPE=£NTEY 333 
TEMIDNT operand 333 
TYPB=ENTRY operand 333 
DFHTLT TYPE=FINAL 334 
DFHTLT TYPB=INITIAL 333 
LDC operand 333 
SUFFIX operand 333 
TYPE=INITIAL operand 333 
DFHTST 335 

control section, DFHTST 
TYPE=INITIAL 335 

end of temporary storage table, DFHTST 
TYPB=FINAL 338 
example 338 

remote queues, DFHTST TYPE=EEMOTE 337 
security checking, DFHTST 
TYPE=SBCUBITY 337 
temporary storage dataids, DFHTST 
TYPE=RECOVERY/BNTRY 336 
DFHTST TYPE=FINAL 338 
DFHTST TYPE=INITIA L 335 
SUFFIX operand 336 

temporary storage ageing limit 336 
TSAGE operand 336 
TYPE=INITIAL operand 336 
DFHTST TYPE=RECOVERY/ENTRY 336 
DATAID operand 336 
TYPE=RECOVEBY/ENTRY operand 336 
DFHTST TYPE=REMOTE 337 
DATA ID operahd 337 
RMTNAME operand 337 
SYSIDNT operand 337 
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DFHTST TYPE DEMOTE (continued) 

TYPE=REMOTE operand 337 
DPHTST TYPE=SECURITY 337 
DATAID operand 338 
RSL operand 338 
TYPE=SECURITY operand 337 
DFHUEXIT TYPE=EP macro, user exit 
interface 553 
DFHXLT 339 

control section, DFHXLT 
TYPE=INITIAL 339 

end of transaction list table, DFHXLT 
TYPE=FINAL 340 

entries in transaction list table, 
DFHXLT TYPE=2NTRY 339 
example 340 
DFHXLT TYPE=BNTRY 339 
TASKREQ operand 340 
transaction code 340 
TRANSID operand 340 
TYPB=£NTRY operand 339 
DFHXLT TYPE=FINAL 340 
DFHXLT TYPE=INITIAL 339 
SUFFIX operand 339 
TYPE=INITIAL operand 339 
DFHXSC — RACF interface module 593 
DFHXSP — external security interface 
module 591 

DFHZCP, user exit routines 502 
DFHZNAC 

action flags set 498 
logging facility 500 
system sense codes received 772 
DFHZNEPI macros 

DFHZNEPI TYPE=ENTRY 409 
DFHZNEPI TYPE=FINAL 410 
DFHZNEPI TYPE=INITIAL 409 
DFHZNEPI TYPE=ENTRY 409 
NEPCLAS operand 410 
NEPNAME operand 410 
transaction—class error-handling 
routine 409 
DFHZNEPI TYPE=INITIAL 
DEFAULT operand 409 
DFTRMLST macro, BTAM 274,323 
digital response messages 329 
DIP operand 210 

DIP, batch data interchange program (DFHSG 
PROGRAM=DIP) 40 

disconnect switched line bit 392 
disk device service times 
DASD seek times 658 
DASD timing data 656 
disk extents, nonsequential 225 
DISMSG operand 309 
DL/I 

backout 464 

backout table 458 

buffer pool size 225 

data oase descriptions (DBDs) 345 

DBDs 34 5 

DDIR 348 

DDIR operand 225 

DFHDLDBD 349 

DLI operand 

DFHDLDBD 349 
DFHDLPSB 348 
DFHSG PROGRAM=DBP 39 


DL/I (continued) 

DLI operand (continued) 

DFHSG PROGRAM=EXP 42 
DFHSG PROGRAM=TBP 55 
DFHSG TYPB=INITIAL 16 
DFHSIT 210 
DLTHRED operand 226 
DEB directory list (DDIR) 349 
DMBPL operand 226 
ENQ control block space 226 
error—exit 469 
generate DDIR (DFHDLDBD) 349 
generate PDIR (DFHDLPSB) 348 
IMS/VS control blocks 345 
PDIR 348 
PDIR operand 229 

program communication blocks (PCBs) 346 
program isolation deadlock 347 
program specification blocks (PSBs) 346 
PSB directory (PDIR) list 348 
PSB operand 230 
PSB pool size 230 
PS3PL operand 230 
restrictions on IMS/VS batch 
programmer 350 
scheduling 229 
shared data base support 
ACCMETH=IRC 57 
APPLID operand 206,248 
DFHSG PROGRA M=ISC 46 
DFHTCT TYPE=IRCBCH 259 
macros and operands 347 
OSCOR 227 
programs 47 
system generation 76 
TCT example 736 
statistics output 748 
system generation 75,76 
table preparation 345 
with CICS/DOS/YS 75,345 
with CICS/OS/VS 
DBDs 345 
PCBs 345 
PSBs 345 

system generation 75 
DLI operand 16 
DLTHRED operand 226 
DMBPL operand 226 
DOMAIN operand 

DFHTC CTYPE=LOCATE 580 
DOS/VSE (see VSE) 

DSB operand 210 
DSCNAME operand 

DFHDCT TYPE=EXTRA 87 
DFHDCT TYPE=SDSCI 94 
DFHTCT TYPE=LINE 271 
DFHTCT TYPB=SDSCI 284 
DSECTPR operand 375 
DSETID operand 600,603 
DSN operand 261 
DTB operand 

DFHPCT TYPE=ENTRY 167 
DFHPCT TYPE=INITIAL 160 
DFHSG PROGRAM=JCP 49 
DTF information 281 
DTIMOUT operand 168 
dummy terminal indicator 392 
DUMMY=YES operand 13 


810 


CICS/VS System Programmers Reference Manual 



DUMMY=YES operand (continued) 


DFHSG 

PROGRAM=BFP 

25 

DFHSG 

PROGRAM=BMS 

27 

DFHSG 

PROGRAM=DCP 

40 

DFHSG 

PROGRAM=DIP 

40 

DFHSG 

PROGRAM=FCP 

43 

DFHSG 

PROGRAtt=ISC 

48 

DFHSG 

PROGRAM=JCP 

48 

DFHSG 

PROGRAM=KPP 

50 

DFHSG 

PROGRAM=SRP 

55 

DFHSG 

PROGRAM=TDP 

69 

DFHSG 

PROGRAM=TBP 

70 

DFHSG 

PROGRAM=TSP 

71 


dump 

statistics 747 
dump control program (DFHSG 
PROGRAM=DBP) 39 
DUMP operand 168 
DO PD SID, operand 124 
duplicate data set 124 
DVC operand 261 
DVSUPRT operand 
ACF/VTAM 501 
DFHPCT TYPE=ENTRY 168 
dynamic buffer size 209 
dynamic close of ACF/VTAM ACB 488 
dynamic log 209,424 
dynamic open/close 

closing data sets, DFHOC TYPE=CLOSE 603 
DFHOC macros 599 

opening data sets, DFHOC TYPE=0PEN 599 
program (DFHSG PROGRAH=OCP) 52 
switching dump data sets, DFHOC 
TYPE=SWITCH 604 
dynamic reference set 646 
dynamic storage area 
storage cushion 639 
temporary storage 639 
VSAM buffer storage 640 
working storage 639 
dynamic transaction backout 422 
DBP operand 209 
DTB operand 

DFHPCT TYPE=ENTRY 167 
DFHPCT TYPE=INITIAL 160 
DFHSG PROGRAM=JCP 49 
dynamic buffer 209,424 
dynamic log 209,424 
program (DFHSG PROGRAM=DBP) 39 
recovery/restart 74 
statistics output 751 
transaction restart 342,425 
user exits 422 


EDF (execution diagnostic 
facility) 198,695 
SIP, exec interface program (DFHSG 
PROGRAM=EIP) 40 
EJECT operand 17 
emergency restart 455 
ACF/VTAM 495 
data set recovery 455 
how to specify 221 
message logging (ACF/VTAM) 494 
post—initialization processing, 
DFHTBP 456 

problem determination 455 


emergency restart (continued) 

processing transaction backout data 470 
restart emergency restart 456 
system generation 74 
system log data set 456 
system restart data set 456 
table preparation 343 
temporary storage emergency restart 
interval control data recovery 470 
transaction backout 456 
user activity keypointing 474 
end-of—data indicator 63 
BNQ control block space 226 
ENQPL operand 226 
enqueue lockout 90,115 
ENTRY parameter, EXEC CICS ENABLE 
command 555 
£0DI=xx operand 63 
EOFADDR operand 

DFHJC TYPE=GET 441 
DFHKP TYPE=CHECR 474 
DFHKP TYPE=RTBOCTL 472 
DFHKP TYPE=RTBODATA 473 
EOM operand 284 
EOT operand 285 
ERRATT operand 

DFHTCT TYPS=INITIAL 248 
DFHTCT TYPE=LINE 271 
DFHTCT TYPE-TERMINAL 310 
ERRMSG operand 272 
ERROPT operand 94,285 
error message display on 3270s 
DFHTCT TYPE=INITIAL 248 
DFHTCT TYPE=LINE 271 
DFHTCT TYPE=TERMINAL 310 
error messages and action flags 757 
error messages and codes 753 
DFHTACP 753 
DFHZNAC 757 
node error program 757 
terminal error program 753 
error messages and default actions 753 
ERROR operand 

DFHTC CT YPE =C HE CK 587 
DFHTC CTYPE=LOCATE 581 
DFHTC CTYPE=STATUS 584 
error processing 
execution 369 
routines 401 

TCAM SNA batch logical units 510 
error processors 

DFHSNEP TYPB=DEFILU (INTLU) 407 
DFHSNEP TYPE=DEF3270 406 
source 378 
user-written 410 
vector table (EPVT) 407 
error recovery action 479 
error recovery options 
ERROPT operand 285 
error status blocks 412 
error status elements 

DFHTEPT TYPE=PEfiMCODE/ERRCODE 382 
error status elements (ESEs) 367 
error status information 403 
error—processor selection 369 
errors and actions unique to TCAM, 

DFHTEP 516 
ESB structure 408 
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ESBS operand 408 

ESB information 373 

ESEs (error status elements) 367 

event monitoring points (EMPs) 142 

EVENT operand 

DFHMCT TY?E=INITIAL 142 
exception class 680 
exceptional conditions 

ENABLE, DISABLE, EXTRACT EXIT 
commands 558 
INVEXITREQ condition 558 
EXEC CICS DISABLE command 
examples 557 
EXIT parameter 556 
EXITALL parameter 556 
PROGRAM parameter 556 
STOP parameter 557 
EXEC CICS ENABLE command 
ENTRY parameter 555 
examples 555 
EXIT parameter 554 
GALENGTH parameter 555 
GAPROGRAM parameter 555 
PROGRAM parameter 554 
START parameter 554 
EXEC CICS EXTRACT command 
EXIT parameter 557 
GALENGTH parameter 558 
GASET parameter 558 
PROGRAM parameter 558 
exec interface program (DFHSG 
PROGRAM=EIP) 40 
EXEC operand 210 
execution diagnostic facility 
(EDF) 198,695 
execution speeds 627 
EXIT parameter 

EXEC CICS DISABLE command 556 
EXEC CICS ENABLE command 554 
EXEC CICS EXTRACT command 557 
exit program block (EXIT) 557 
exit programs in user exit interface 552 
accessing a work area, EXEC CICS 
EXTRACT command 557 
disabling, EXEC CICS DISABLE 
command 556 

enabling, EXEC CICS ENABLE command 553 
EXITALL parameter, EXEC CICS DISABLE 
command 556 
EXITS=YES operand 210 

EXP, command language translator program 
(DFHSG PROGRAM=BXP) 41 
extended color feature (3270) 311 

extended data stream support (3270) 311 

extended highlight feature (3270) 311 

extended local LDC list, DFHTCT 
TYPE=LDC 259 
EXTENT operand 120 
extents 

journal 432 
maximum number of 120 
external security interface 591 
interface module DFHXSP 591 
RACF interface module DFHXSC 593 
security identification module 
DFRACEB 593 
EXTRA operand 69 


EXTRACT operand 

DFHPCT TYPE=ENTRY 169 
DFHPCT TYPE=PROFILE 181 
extrapartition data sets 69 
extrapartition destinations, DFHDCT 
TYPE=EXTRA 

destination identification (DESTID) 87 
EXTSEC operand 179,211 
DFHPCT TYPE=ENTRY 169 
DFHPCT TYPE=INITIAL 161 
DFHSNT TYPE=2NTRY 232 
DFHSNT TYPS=INITIAL 231 


facility error recognition system 
(FEES) 224 
FBA 

DEVICE operand 

DFHDCT TYPE=SDSCI 96 
DFHSG PROGRAM=DCP 40 
DFHSG PROGRAM=KPP 51 
DFHSG PROGRAM=TSP 71 
DFHSG TYPE=INITIAL 20 
DFHTCT TYPE=SDSCX 282 
JDEVICE operand, DFHJCT TYPE=ENTRY 140 
FCP operand 211 

FCP, file control program (DFHSG 
PROGRAM=FCP) 43 
FCT operand 211 

FCT, file control table (DFHFCT) 101 

FDP operand 211 
FDUMP operand 161,169 
FEATURE operand 

DFHSG PROGRAM=TCP 64 
DFHTCT TYPE=LINE 272 
DFHTCT TYPE=REMOTE 281 
DFHTCT TYPE=SDSCI 287 
DFHTCT TYPE-TERMINAL 310 
2260 display station 534 
FEES operand 224 
FF=YES operand 281,313 
field relocation 30 
FILABL operand 96 
file backout table 458 
file control program (DFHSG 
PROGRAM=FCP) 43 

file control table (DFHFCT) 101 

file management 101 

file service reguests 108 

FILSERV operand 43 

FILSTAT operand 112 

FIX operand 83,153 

fixed block architecture disk devices (see 
FBA) 

FLDSEP operand 212 
FLDSTRT operand 212 
FLNNAME operand 290 
FMH processing 509 
FMT2260 operand 64 
FMT3270 operand 64 
FN operand 176,197 
forced pageout 195 

format description of TACLS DSECT 389 

FORMAT mode 533 

format of macro instructions 4 

format of records 116 

FORMAT=SMF operand 138 
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(continued) 


formatted damp program 
DFHPCT TYPE=BNTRY 169 
DFHPCT TYPE=INITIAL 161 
FDP operand, DFHSIT 211 
formatted 2260 screen 535 
forms feed (FF) SCS control 
character 281,313 
FREQ operand 145 

frequency, user activity keypointing 474 

FSTTERM operand 273 

full warm restart 453 

FULLBUF mode 533 

functional groups 176,197 

functions performed by DFHT3P 456 

F2260 operand 211 


GALBNGTH parameter 

EXEC CICS ENABLE command 555 
EXEC CICS EXTRACT command 558 
GAP, graphic attention program (DFHSG 
PROGRAM=GAP) 44 

GAPROGRAM parameter, EXEC CICS ENABLE 
command 555 

GASET parameter, EXEC CICS EXTRACT 
command 558 

generalized message format, TCAM 522 
generate DDIR (DFHDLDBD) 

data base description block (DBD) 350 
DBD operand 350 
SUFFIX operand 349 
TYPE=ENTRY operand 349 
TYPE=INITIAL operand 349 
generate logical units 301 
generate PDIR (DFHDLPSB) 348 
MXSSASZ operand 348 

program specification blocks (PSBs) 348 
PSB operand 348 
RMTNAME operand 349 
segment search argument 348 
SUFFIX operand 348 
SYSIDNT operand 349 
TYPE=ENTRY operand 348 
TYPE=INITIAL operand 348 
GENPOLL=YES operand 273 
GMMSG operand 313 
GMTEXT operand 249 
GPBLKSZ operand 255 
GPNAME operand 255 
GPNTRMS operand 255 
GPSEQLU operand 255 
GPTCU operand 255 
graphic attention program (DFHSG 
PROGRA M=GA?) 44 
group entry macro 

DFHTCT TYPE=GPENTRY 251 
TCT examples 737 
GROUP operand 411 
GTYPE operand 252 


HANDLE ABEND command 419 
header of segmented record, DFHFCT 
T YPE=SEGHEAD 128 
HF operand 281,314 
high performance option (HPO) 
DFHFCT TYPE=ALTERNATE 103 
DFHOC TYPE=OPEN 602 


high performance option (HPO) 
mixed mode files 103,121 
MODE operand 121,602 
protected storage, DFHNLT 154 
SRBSVC operand 21 
VSAM ICIP 103 

high-level language support group (DFHSG 
PROGRAM^HLL) 45 
high-level language trace 53 
highlight facility, 3270 311 

HLL, high-level language support (DFHSG 
PROGRAM=HLL) 45 
HLLTR operand 53 

host processor response and maximum 
loading 659 

derivation of input data 661 
example 661 

treatment of page—faults 663 
host processor utilization 611 

calculating background processor 
utilization 615 

calculating transaction processor 
utilizations 615 

defining transactions and transaction 
rates 613 

total processor utilization 616 
transaction execution times 614 
HOT start (PPT) 4 53 

HPO, see High Performance Option 103 


IADADMI operand 124 
IADIII operand 124 
IALKFL operand 123 
IARLKP operand 123 
ICP operand 213 

ICP, interval control program (DFHSG 
PROGRAM=ICP) 46 

ICV operand 213 
ICVR operand 214 
ICVS operand 214 
ICV SWT operand 225 
ICVTSD operand 214 
ID operand 143 
ID verification, 3740 
ANSWRBK-EXIDVER 544 
IDERROR operand 

DFHJC TYPE=CLOSE 438 
DFHJC TYPE=GET 441 
DFHJC TYPE=OPEN 436 
IEFRH macro 509 
IIP operand 214 
IMS/VS control blocks 345 
in—flight tasks 471 
INAREAL operand 267 
INBFMH operand 

DFHPCT TYPE=ENTRY 170 
DFHPCT TYPE=PROFILE 181 
INDAREA operand 113 
INDDEST operand 89 
INDDISP operand 128 
index buffers 111 
INDEX operand 

DFHDCT TYPE=INITIAL 85 
DFHFCT TYPE=ALTERNATE 105 
DFHFCT TYPE=DATASET 121 
DFHPCT TYPE=INITIAL 161 
DFHPPT TYPE=INITIAL 193 
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index skip feature 120 
indexing 161,193 

indirect data destinations, DFHDCT 
TYPE=INDIRECT 88 
INDSIZE operand 113 
INDSKIP-YES operand 120 
INDSYS operand 

DFHTCT TYPE-SYSTEM 294 
initial input record 463 
initialization, DFHSG TYPE=INITIAL 14 
initiating 2260 transactions 539 
INXTRL=YES operand 68 
input BSAM data set control name 273 
input processor, ATP 570 
INPUT status 325 
input user exit (XTCTIN) 524 
inquiry mode, 3735 541 

intercommunication facilities 
DFHDCT TYPE=REMOTE 92 
DFHFCT TYPE=REMOTE 126 
DFHPCT PYPE=PROFILE 191 
DFHPCT TYPE=RBMOTE 182 
DFHSG PR OGHAM=1SC 46,47 
DFHTCT TYPE=RBGIO» 279 
DFHTCT TYPE=REMOTE 279 
DFHTCT TYPE=SYSTEM 292 
DFHTST TYPE=REMOTE 337 
ISC operand 214 
journal records 446 
message performance option 296 
parallel sessions 300 
performance information 665 
program group (DFHSG PROGRAM=ISC) 46 
rules and restrictions 355 


session types 296 
sharing TCTTE information 279 
statistics output 748,751 
table preparation 353 
TCT example 732 
interregion communication 
DFHTCT TYPE=IRCBCH 259 
IRCSTRT operand 214 
programs 47 

interval control data recovery 470 
interval control program (DFHSG 
PROGRAM=ICP) 46 
INTLOG status 325 
INTRA operand 69 

intrapartition destinations, DFHDCT 
TYPB=INTRA 89 


intrapartition queues 
INVADDR operand 

DFHTC CTYPE=CHECK 
DFHTC CTYPE=LOCATB 
DFHTC CTYPE=STATUS 
INVEXITREQ condition, 
interface 558 


69 


587 

581 

584 

user exit 


INVID operand 

DFHTC CTYPE=CHECK 587 
DFHTC CTYPB=LOCATE 581 
DFHTC CTYPE=STATUS 584 


INVLDC operand 

DFHTC CTYPE=CHECK 587 
DFHTC CTYPE=STATUS 584 
INVREQ operand 

DFBJC TYPE=GET 441 
DFHJC TYPE=0PEN 436 
DFHTC CTYPE=CBECK 587 


INVREQ operand (continued) 

DFHTC CTYPB=STATUS 584 
IOCP operand 226 
IOERROR operand 

DFHJC TYPE=CLOSE 438 
DFHJC TYPE=GET 441 
DFHJC TYPE=OPEN 43b 
DFHKP TYPE=CHECK 474 
DFHKP TYPE=RTBOCTL 472 
DFHKP TYPE=RTBODATA 473 
IOSIZE operand 113 
IOWORK operand 121 
IPL status, system/7 326 
IPL system/7 

BSC lines 531 
start/stop lines 531 
write transaction 531 
IRCSTRT operand 214 
ISADSCN operand 273 
ISC message performance option 296 
ISC operand 214 
issue ACF/VTAM indicator 579 


JCP operand 214 

JCP, journal control program (DFHSG 
PROGRAM—JCP) 48 
JCT operand 215 
JCT, gournal control table (see 
DFHJCT) 136 
JDEVICE operand 140 
JFILEID operand 

DFHJC TYPE =CLOSB 439 
DFHJC TYP£=GET 441 
DFHJC TYPE=OPEN 436 
DFHJCT TYPE=ENTRY 137 
DFHPCT TYPE=ENTRY 170 
DFHPCT TYPE=PROFILE 182 
logical units 501 
JID operand 105,113 
job control for sample DFHTEP 
generation 374 
JOBNAME operand 17 
journal 

devices 432 
extents 432 

journal control program (DFHSG 
PROGRA M=JCP) 48 

journal control tanle (see DFHJCT) 
journal file identification 113,137 
journal function and module 
identifications 444 
journal management 431 

additional journal options 434 
application programming 435 
automatic journaling 432 
automatic logging 431 
buffer size 432 
emergency restart 432 
journal control table 432 
journal devices 432 
layout and contents of journal 
records 442 
statistics 433 
journal records 432 
journaled data 447 
journaling 

automatic 48 


136 
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ournaling (continued) 
options 138 
requests 114 

type of journal data set 138 
journals, statistics output 750 
OUROPT operand 138 
REQ operand 105,114 
TYPE operand 138 


CP operand 215 

CP, task control program (DFHSG 
PROGRAM=KCP) 49 
ey field 118 
ey length 

logical 115 
maximum 131 
physical 110 
eyboard lock feature 65 
:EYID operand 179 
:EYL£N operand 

DFHFCT TYPE=DATASET 115 
DFHFCT TYPE=R£MOTE 126 
DFHFCT TYPE=SHRCTL 131 
;eypoint program (DFHSG PROGRAM=KPP) 50 
:eypoint records 474 
:eypointing 

abnormal termination 205 
activity 50 
:PP operand 215 
LPP, keypoint program (DFHSG 
PROGRAM=KPP) 50 


jANG operand 

DFHSG PROGRAM=EXP 42 
DFHSG PROGRAM=HLL 45 
DFHSG PROGRAM =PCP 53 
.ast segment set, DFHFCT TYPE=SEGLAST 129 
,ASTID operand 328 
,ASTTRM operand 

DFHTC CTYPE=CHECK 587 
DFHTC CTYPE=LOCATE 581 
DFHTC CTYPE=STAT T JS 584 
DFHTCT TYPE=TSEMINAL 314 
Layout and contents of journal records 442 
journal function and module 
identifications 444 
journaled data 447 
system prefix 445 
user prefix 447 
:,DC=YES operand 584 
-DCs 

DFHTCT TYPE=LDC 259 
DFHTCT TYPE=LDCLIST 264 
extended local list 263 
extended local list for 3770/3790 
BATCHDI 732 
LDC operand 

DFHTC CTYPE=LOCATE 581 
DFHTCT TYPE=LDC 261 
DFHTCT TYPE=LDCLIST 264 
DFHTCT TYPE=REMOTE 281 
DFHTCT TYPE=TERMINAL 314 
DFHTLT TYPE=INITIAL 333 
LUTYPE4 261,314 
3770 batch TCT example 731 
LEAVE operand 439 


LENGTH operand 93 
LERBADR operand 286 
line 

addressing, 2260 539 

connection 289 
error recording block 286 
features 255 
group types 

DFHTCT TYPE=GPENTRY 251 
TCT examples 737 
input/output area (LIOA) 525 
locking, TCAM 518 
macro (BTAM/TCAM) 265 
permanent lock 519 
pool restrictions, TCAM 518 
pool specifications, TCAM 517 
SWITCH operand 289 
temporary lock 519 
line pool specifications 

line pool restrictions 518 
POOL feature 517 
LINELST operand 255,288 
LINFEAT operand 255 
LININL operand 256 
link pack area (OS/VS) 155,226 
LINSTAT =l OUT OF SERVICE 1 operand 273 
LISTADR operand 274,601 

local LDC list, DFHTCT TYPE=LDCLIST 264 
LOCAL operand 263 
local video unit 315 
LOCALQ operand 

DFHPCT TYPE=RBMOTE 183 
lock feature, 2260 539 

lock option 273 
L0CKF=YES operand 65 
LOG operand 105,115 
logic flow, TCAM 513 
logical device codes (see LDCs) 
logical key length 115 
logical record length 116 
logical record presentation 
DFHPCT TYPE=ENTRY 170 
DFHSG PROGRAM=TCP 65 
logical unit I/O error handling 
(DFHZNAC/DFHZNEP) 496 
logical unit of work 457 
logical unit, changing status of 579 
logical units 

DFHZNAC action flags 757 
generate 301 

node error program 401,496 
TCT examples 722 
VTAMDEV operand 67 

logically recoverable destinations 90 
LOGMODE operand 315 
LOGREC operand 

DFHPCT TYPE=ENTRY 170 
DFHSG PROGRAM=TCP 65 
LPA operand 226 
LPLEN operand 315 
LRECL operand 116,126 
LUTYPE2 

TRMTYPE operand, DFHTCT 
TYPB=TERMINAL 301 
VTAMDEV operand 68 
LUTYPE3 

TRMTYPE operand, DFHTCT 
TYPB=TERMINAL 301 
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LUTYPE3 (continued) 

VTAMDEV operand 68 
LUTYPE4 

default page size 316 
LDC mnemonics 261 
LDCs 261,314 
TCT example 737 
TRMTYPE operand, DFHTCT 
TYPE=TERMINAL 301 
VTAMDEV operand 68 
word processing media 261 
LUTYPE6 

session processing options 
DFHPCT TYPE=PROFILE 181 
VTAMDEV operand 68 
LVUNIT operand 315 


MACRF operand 290 
magnetic stripe reader 164 
MAPALGN operand 32 
MAPHC operand 33 

mapping individual records and entire 
chains 504 
mapset suffixes 193 
MAP3270 operand 32 
master index, ISAM data sets 120 
master terminal program pFHSG 
PROGRAM=MTP) 51 
MAXBUF operand 145 
MAXERRS operand 381 
maximum 

buffer size 433 
key length 131 

number of active asynchronous tasks 207 
number of active tasks 206 
number of extents 120 
number of tasks per transaction 
CMXT operand 208 
MAXTIDS operand 381 
MCP operand 215 
MCT operand 215 

MCT, monitoring control table (DFHMCT) 141 
message 

cache 463,495 

control program, TCAM 521,529 
control programs, examples 777 
DEST operand 517 
format, TCAM 522 
handler, PC AM 511 
input area length 267 
integrity 180 
logging 493 

MCP (TCAM message control program) 529 
option groups 179,493 
protection 180 
protection processing 493 
recovery 456,492 
recovery and emergency restart 
message cache 492 

node abnormal condition program 492 
system log 492 

recovery and resynchronization 460 
routing, TCAM 517 
switching 332,505 
table 457 

MESSAGE operand 328,329 
message option group 171 


message routing 34 

OPCLASS operand 233 
message switching 

BMSTXB operand 32 
ROUTING operand 34 
message—originated transactions 461 
minimum buffer size 433 
mixed mode files (VSAM ICIP) 121 
MOD operand 17 

mode of communication, BSC 290 
MODE operand 

DFHFCT TYPE=DATASET 121 
DFHOC TYPE=OPEN 602 
DFHTCT TYPE=SDSCI 290 
model-dependent data stream (2260) 535 

MODELST operand 289 
modes of compatibility, 2260 533 

modifying terminal control table 

changing status of logical unit 579 
checking outcome of operation 579 
command option (logical units), DFHTC 
CTYPE=COMMAND 588 
issue ACF/VTAM indicator 579 
scanning terminal control table 579 
terminal locate function, DFHTC 
CTYPE=LOCATE 579 
modifying the TCT 579 
MODNAME operand 96,250 
module load sequence, DFHNLT 
TY PE=ENTRY 151 
MODULE operand 152 
module sizes 630 

modules generated by system generation 
macros 741 
MONDLY operand 286 
MONITOR operand 215 
monitoring 

format of SMF data 685 
monitoring control table (DFHMCT) 141 

monitoring facilities 679 
accounting class 679 
classes of monitoring 679 
DFHMCT 141 
exception class 680 
performance class 680 
using the facilities 680 
monitoring programs (DFHCMP, DFHCMON, 
DFHCCMF) 

DFHSG PR0GRAM=CS0 35 
monitoring records 

accounting class 681 
exception class 683,684 
performance class 682 
record content 681 
user data 684 

motor-on optional feature 286 
MSGCLAS operand 22 
MSGJRNL operand 
ACF/VTAM 501 
DFHPCT TYP£=ENTRY 171 
DFHPCT TYPE=PROFILE 182 
MSGLVL operand 22,215 
MSGPOPT operand 

DFHPCT TYPE=OPTGRP 180 
MSGPREQ operand 
ACF/VTAM 493 
DFHPCT TYPE=OPTGRP 180 
MSTIND=YES operand 120 
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ITP, master terminal program (DFHSG 
PROGRAM=MTP) 51 
Bultiple ISAM data sets 125 
aultiple track search IIS 
nultiprocessor recovery procedures 475 
ACF/VTAM 476 
BTAM 476 

channel reconfiguration hardware 
(CRH) 476 
TCAM 477 

4XSSASZ operand 343 
4XT operand 216 
432 operand 215 


SAME operand 406,407 
SAMFORM=DEC operand 233 
NEBNAME operand 408 
NEBS operand 408 
aegative poll delay 275 
SEPCLAS operand 

DFHPCT TYPE=ENTRY 171 
DFHPCT TYPE=PROFILE 182 
DFHZNEPI TYP2=ENTRY 410 
NEPNAME operand 410 
NETNAME operand 

DFHSNEP TYPE=INITIAL 406 
DFHTC CTYPE=LOC»TE 582 
DFHTCT TYPE=SYSTEM 294 
DFHTCT TYPE=TERMINAL 315 
NETNAMQ operand 315 
network component pathlengths 618 
network name 294,315 
new-line symbol (NL) , 2260 538 

NLT operand 216 

BLT, nucleus load table (DFHNLT) 146 
node abnormal condition program 
ACF/VTAM message recovery 492 
logical unit I/O error handling 496 
node error program 401 
node error blocks 412 
node error program 401 

ACF/VTAM error actions 757 
DFHZNEPI macros 409 
error messages and action flags 757 
interface module, DFHZNEPI 409 
node abnormal condition program 401 
sample 401 

system sense codes received 772 
terminal control program (ACF/VTAH 
portion) 401 
user-written 408 

when abnormal condition occurs 401 
3270 unavailable printer 413 
node error table 403 
node error table header 412 
node initialization block (NIB) 488 
NOINTLOG status 325 
non-compatible interfaces 7 
non—conversational transactions 613,646 
non—message—originated transactions 461 
non-purgeable task 392 
non—VTAM error actions 753 
noncatastrophic failures 496 
nonprotected tasks 493 

nonresident extrapartition data sets 97 
nonsequential disk extents 225 


NORESP operand 

DFHJC TYPE=CL0SE 439 
DFHJC TYP2=GET 441 
DFHJC TYP3=OPEN 436 
DFBKP TYPE=CHECK 474 
DFHKP TYPE=RTBOC'TL 472 
DFHKP TYPE=RTBODATA 473 
DFHTC CTYPE=CHECK 587 
DFHTC CTYPE=LOCATE 582 
DFHTC CTYPE=STATUS 584 
NOTE operand 49 
NOTOPEN operand 441 
NPDELAY operand 275 
NRECDS operand 120 
NSD operand 225 

nucleus load table (DFHNLT) 146 
nucleus module name 152 


OBJDSID operand 123 
object data set 123 
object-compatible interfaces 

control block and area prefix fields 6 
OCP, dynamic open/close program (DFHSG 
PROGRAH=OCP) 52 

online terminal test facility 289 
online test facility 286 
OPCLASS operand 233 
OPEN operand 

DFHDCT TYPE=EXTRA 87 
DFHFCT TYPE=DATASET 116 
DFHJCT TYPE=ENTRY 139 
opening data sets, DFHOC TYPE=OPEN 599 
opening journal data sets, DFHJC 
TYPE=0PEN 435 
operating system 
abend code 236 
abends 73,342 
storage requirements 645 
operating system and major access method 
storage requirements 629 
operator 

identification code 315 
priority 316 
security key 316 
OPERID operand 315 
OPERPRI operand 316 
OPERRSL operand 316 
OPERSEC operand 316 
OPIDENT operand 232 
0PNAM3 operand 232 
OPNDLIfl operand 249 
OPPRTY operand 233 
OPSYS operand 18 
OPTCD operand 290,517 
OPTGRP operand 171 
optional common subroutines 404 
optional error processor for INTLU 405 
optional error processors for 3270 404 

OPTIONS operand 375,382 
OS/VS 

abend codes 237 
JCL options 22 
processing unit console 
TCT example 737 
OS/VS console as terminal 
CONSLID operand 327 
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OS/VS console as terminal (continued) 
TRMTYPE operand, DFHTCT 
TYPE=TERMINAL 300 
OSADSCN operand 275 
OSCOR 

definition 640 
operand 227 

OUT OF SERVICE status 326 
output 

BSAM data set control name 275 
processor (CWTR) 572 
user exit (XTCTOUT) 524 
OUTQ operand 273 
overflow records, cylinder 119 


PA and PF keys for PCT groups 179 

page alignment 152 

page fixing 153 

page-alignment 82 

page—chaining command 216 

page-copy command 217 

page-faults 663 

page—fix SVC 21 

page-fixing 83 

page—purge command 217 

page—retrieval command 217 

PAGEIN operand 153 

PAGEOUT operand 83,154 

paging activity 263,318 

PAGING operand 33 

parallel sessions (VTAM) 

S ESTY PE= SEND/RECEIVE 300 
parity check 119 
partition aoend recovery 479 
partition/tegion exit time interval 
ICV operand 213 
PASSWD operand 105,116 
PASSWRD operand 233 
PBP operand 216 
PCBs (see program communication 
blocks) 346 
PCP operand 216 

PCP, program control program (DFHSG 
P RO GR AM =PC P) 52 
PCT operand 216 

PCT, program control taole (DFHPCT) 159 

PDIR operand 229 

PERFORM operand 143 

performance aspects 609 

performance class 680 

performance data 609 

permanent line lock 519 

PGCHAIN operand 216 

PGCOPY operand 217 

PGESIZE operand 

DFHTCT TYPE=LDC 263 
DFHTCT TYPE=REMOTE 281 
DHFTCT TYPB^TBRMINAL 316 
PGESTAT operand 263,318 
PGMERID operand 22 
PGMLANG operand 193 
PGMSTAT operand 194 
PGPURGE operand 217 
PGRET operand 217 
PGSIZE operand 217 
phonetic codes and keys 

DFHBIF TYPE=PHONETIC 605 


phonetic codes and keys (continued) 

DFHPHN 605 

DFHSG PROGRAM=BFP 605 
physical I/Os, calculate disk device 
service times 655 
physical key length 110 
physically recoverable destinations 90 
pipeline session 65,318 
PIPELN operand 65,318 
PISCHD operand 229 
PL/I programs 

LANG operand 42,45 
PGMLANG operand 193 
PLI operand 217 
PLI/PL1=SHARE operand 42 
PLILIB operand 43,46 
PLISHRE operand 229 

PLT, program list table (DFHPLT) 188 

PLTPI operand 218 

PLTSD operand 218 

PL1/PLI operand 46 

poll list, 3600 BSC 545 

polling position 318 

POLLPOS operand 318 

POOL feature, TCAM 517 

pool of common TCTTEs 512 

pool of TCTLEs 278 

POOL=YES operand 278 

POOLADR operand 276 

POOLCUT operand 278 

positioning information 49 

post—initialization phase 189 

post-initialization processing, DFHTBP 456 

PPT operand 218 

PPT, processing program table (BFHPPT) 192 
PREFIX operand 23 

PREGEN, starter system generation (DFHSG 
PROGRAM=PREGEN) 53 
PRGDLAY operand 218 
primary printer 319 
primary systems, ISC 

SESTYPE=SEND, DFHTCT TYPE-SYSTEM 296 
primed storage allocation 175 
print line length 315 
PRINT operand 

DFHSG TYPE=INITIAL 18 
DFHSIT 219 

DFHTEPM TYPE=INITIAL 376 
printer authorization matrix 219 
printer-adapter feature (3270) 312 

PRINTTO operand 319 
PRIORTY operand 23 
PRIVATE operand 171 
PRMSIZE operand 175 
problem determination, emergency 
restart 455 

process control information field 
(PCI) 276,321 
process queue, TCAM 279 
processing program table (DFHPPT) 192 
processing programs, DFHPPT TYPE=ENTRY 193 
processing transaction backout data 470 
active tasks 471 
DFHKP macro instructions 472 
in-flight tasks 471 

processing unit console as OS/VS terminal 
CONSLID operand 327 
TCT example 717 
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processing unit console as OS/VS terminal 
TRMTYPE operand, DFHTCT 
TYPE=TERMINAL 300 
PROCNMS operand 23 
PROFILE operand 

DFHPCT TYPE=PROFILE 181 


program check 

application programs 73,342 
error recovery action 479 
partition abend recovery 479 
recovery 479 

program communication blocks (PCBs) 346 
program control program (DFHSG 
PROGR AM=PCP) 52 

program control table (DFHPCT) 159 
program error program (DFHPEP) 421 
program generation summary 

modules generated by system generation 
macros 741 

program isolation scheduling 229 
program list table (DFHPLT) 188 
program load request 194 
program load seguence, DFHALT 
TYPE=ENTRY 82 
PROGRAM operand 13 

DFHALT TYPE=ENTRY 82 
DFHPCT TYPE=ENTRY 163 
DFHPLT TYPE=ENTRY 190 
DFHPPT TYPE=ENTRY 193 
DFHSRT TYPE=SXSTEM/US£R 237 
PROGRAM parameter 

EXEC CICS DISABLE command 556 
EXEC CICS ENABLE command 554 
EXEC CICS EXTRACT command 558 


program specification block directory list 
(PDIR) 348 

program specification blocks 
(PSBs) 346,348 

program storage 639 
PROGRAM=ATP operand 24 
PROGRAM=BFP operand 25 
PROGRAM=BMS operand 27 
PROGRAM=CSA operand 34 
PROGRAM=CSD operand 35 
PROGRAM=CSO operand 37 
PROGRAM=CSS operand 38 
PROGRAM=CSU operand 39 
PROGRAM=DBP operand 39 
PROGRAM=DCP operand 40 
PROGRAM=DFHDELIH operand 
DFHPLT TYPE=ENTRY 191 
PROGRAM=DIP operand 40 
PROGRAM=DLZSTP00 operand 


DFHPLT TYPE=ENTRY 
PROGRAM=EIP operand 
PROGRAM=EXP operand 
PROGRAM=FCP operand 
PROGRAM=GAP operand 
PROGRAM=HLL operand 
PROGRAM=ICP operand 
PROGRAM=ISC operand 
PROGRAM=JCP operand 
PROGRAM=KPP operand 
PROGRAM=MTP operand 
PROGRAM=OCP operand 
PROGRAM=PCP operand 
PROGRAM=SCP operand 
PROGRAM=SRP operand 


191 

41 

42 

43 
45 

45 

46 
48 
48 
50 
52 
52 
52 

54 

55 


(coPROGRAM=TBP operand 55 
PROGRAM=TCP operand 57 
PROGRAM-TDP operand 69 
PROGRAM=TRP operand 70 
PROGRAM=TSP operand 71 
PROTECT operand 154 
protected storage (HPO) 154 
protected tasks 493 
protocol management 508 
PSB directory (PDIR) list 348 
PSB operand 230,348 
PSB pool size 230 
PSBPL operand 230 
PSBs (see program specification 
blocks) 346 
PUNSOL operand 65 
purge delay time interval 218 


gueue considerations, TCAM 519 
queue locks, TCAM 519 
QOEUEID operand 279 
guiesce, first stage 189 


RACF interface module DFHXSC 593 
RAMAX operand 249,490 
RAMIN operand 249 
RAPOOL operand 250 
RAQ operand 

DFHPCT TYPE=ENTRY 171 
RATIMES operand 250,490 
RDYMSG operand 276 
read ahead queuing option 
DFHPCT TYPE=ENTRY 171 
read Journal data sets 447 
backward 449 

DFHJC TYPE=(GETJCA,OPEN) 453 

during CICS/VS execution 449 
forward 450 
offline 447 

read time-out feature 172 
read transaction backout control 
record 472 

read transaction backout data 473 
ready message, 7770 276 

RECEIVE operand 295 
RECEIVE status 326 
RECFM operand 291 

DFHTCT TYPE=SYSTEM 295 
RECFORM operand 

DFHDCT TYPE=SDSCI 94 
DFHFCT TYPE=ALTERNATE 105 
DFHFCT TYPE=DATASBT 116 
record 

format 116,291 
identification field 123 
length 9 4 

logical record length 116 
variable length 94 
RECOVER operand 54 
recoverable destinations 69 
recovery/restart 361 

CICS/VS emergency restart 74,343 
dynamic transaction backout 74,342 
emergency restart 455 
journal management 431 
multiprocessor recovery procedures 


475 


Index 819 



recovery/re start (continued) 
node error program 401 
operating system abends 73,342 
program check 479 
program checks in application 
programs 73,342 
system abend 427 
system generation 73 
telecommunications errors 73,341 
terminal error program 363 
transaction abend 415 
transaction restart 342 
warm restart 

description 453 
system generation 74 
table preparation 342 
RECSIZE operand 94 
reference set tables 647 
REGION operand 23 
relative addressing 117 
relative line number 270 
relative power factors 615 
RELOAD operand 194 
RELREQ exit—routine 489 
RELREQ operand 319 
RELTYPE operand 117 

remote files, DFHFCT TYPB=REMOTB 126 
remote temporary storage queues, DFHTST 
TYPE=REMOTE 337 
remote transactions, DFHPCT 
TYPE=REMOTE 182 

remote transient data destinations, DFHDCT 
TYPE=REMOTS 92 
request unit 319 
RES operand 195 
RESIDNT operand 88 
resource limit 131 
resource security level 
DFHDCT TYPE=EXTRA 88 
DFHDCT TYPE=INTRA 91 
DFHFCT TYPE=DATASET 118 
DFHDCT TYPE^ENTRY 139 
DFHPCT TYPE=BNTRY 172 
DFHPPT TYPE=ENTRY 196 
resource security level checking 
description 231 
RSLC operand 172 
RESP operand 250 
response type 250 
restart emergency restart 456 
RESTART operand 172 

restrictions on IMS/YS batch application 
programmer 350 
retrieve LDC information 579 
RETRY operand 289 

reusable VSAH data sets, SERVREQ-REUSE 109 

REUSE operand 91 

REWIND operand 95 

RKP operand 118 

RLE operand 220 

RMTNAME operand 

DFHDCT TYPE=REMOTE 93 
DFHDLPSB TYPE=ENTRY 349 
DFHFCT TYPE=RBM0T2 126 
DFHPCT TYPE=REMOTE 183 
DFHTST TYPE=REMOTE 337 
rotational position sensing 125,656 
ROUTINE operand 237 


routing mechanism 403 
ROUTING operand 34,503 
RPFs (see relative power factors) 
RPG II programs 

LANG operand 42,45 
PGMLANG operand 193 
RPL pool size 504 
RPLs 490 

RPS =S VA operand 125 
RSCLMT operand 131 
RSDBLKS operand 51 
RSL operand 

DFHDCT TYPE = REMOTE 93 
DFHDCT TYPE=EXTRA 88 
DFHDCT TYPE=INTRA 91 
DFHFCT TYPE=DATASET 118 
DFHDCT TYPB=BNTRY 139 
DFHPCT TYPE=ENTRY 172 
DFHPPT TYPE=EMTRY 196 
DFHTST TYPE=SECURITY 338 
RSLC operand 172 
RSLKEY operand 234 
RTIMOUT operand 172 
runaway task time interval 
ICVR operand 214 
RUSIZE operand 319 

DFHTCT TYPE=SYSTEM 294 
RVI (reverse interrupt) 267 


sample node error program 401 

common subroutine vector table 403 
compatibility with sample TEP 402 
components 403 
DFHSNEP TYPE=INITIAL 406 
DFHSNET 407 

error processing routines 401 
error processor vector table 403 
error processor vector table (EPVT) 407 
error processors for INTLU, DFHSNEP 
TYPE=DEFILU 407 
error processors, DFHSNEP 
TYPE=DEF3270 406 
error status information 403 
node error table 403 
optional common subroutines 404 
optional error processor for INTLU 405 
optional error processors for 3270 404 

routing mechanism 403 
sample node error table 407 
user-supplied error processors, DFHSNEP 
TYP£=ERRPROC 410 
sample TCAM SNA message control 
programs 777 

sample terminal error program 365 
common subroutines 369 
components 356 

default threshold count limits 383 
define terminal error blocks 

tables, DFHTEPT TYPE-PERMTID 382 
DFHTEP tables 380 
DFHTEPM TYPE=ENTRY 378 
DFHTEPM TYPS=EXIT 378 
DFHTEPM TYPE=INITIAL 374 
DFHTEPT TYPE=PERMCODE/ERRCODE 382 
error processing execution 369 
error processor source 378 
error status elements (ESEs) 367 
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sample terminal error program (continued) 
error—processor selection 369 
general entry and initialization 368 
general exit 369 
generate sample TEP module 374 
jot control for sample DFHTEP 
generation 374 
messages 

action flag names 372 
DECB information 372 
DECB operand 372 
ESE information 373 
TACLE information 372 
overview 371 

replace error processors, DFHTEPM 
TYPE=ERRPROC 378 
tables 

default thresnold count limits 385 
DFHTEPT macro examples 386 
DFHTEPT TIPE=BUCKET 385 
DFHTEPT TYPE=INITIAL 381 
TEP default table 367 
TEP error table 366 
terminal error blocks (TEBs) 366 
terminal identification and error-code 
lookup 368 

TYPE=PERMCODE/ERRCODE operand 383 
sample terminal error program module 
DFHTEPM macro examples 379 
end of sample DFHTEP, DFHTEPM 
TYPE=FINAL 379 

scanning terminal control table 579 
scheduling 

program isolation 229 
segment intent 229 
SCP operand 220 

SCP, storage control program (DFHSG 
PROGRAM=SCP) 53 
screen format, 2260 324 

screen sizes 

alternate 281,303 
alternate map suffixes 304 
default 281,309 
screen techniques, 2260 535 

SCRNSZE operand 

DFHPCT TYPE=BNTRY 173 
DFHPCT TYPE=INITIAL 161 
SCS operand 220 
SCS printer logical unit 
TRMTYPE operand, DFHTCT 
TYPE-TERMINAL 301 
VTAMDEV operand 68 
SCTYKEY operand 234 
search argument type 124 
secondary systems, ISC 

SESTYPE=RBCEIVE, DFHTCT TYPE=SYSTEM 296 
security 

interface to external manager 591 
seek time 655 
SEGCHAR operand 127 
SEGLENG operand 127,128 
segment characteristics 127 
segment indicator field 128 
segment intent scheduling 229 
segment length 127 

segment processing, OPTCD operand 517 
segment processing, TCAM 517 
segment search argument 348 


segment sets 129 

segments of segmented record, DFHFCT 
TYPE=SEGDEF 127 
SEGNAME operand 127,130 
SEGSET operand 130 
selective transaction abend 427 


selector pen feature 312 
SEND operand 295 
SEPASMB operand 86 
sequence of events, TCAM 513 
sequential terminals 

DFHTCT TYPE=GPENTRY 251 
DFHTCT TYPE=SDSCI 281 
service request block SVC 21 
SERVREQ operand 104,108 
S2SNUMB operand 259 
session failure, user actions 414 
session processing options (LUTYPE6) 

DFHPCT TYPE=PROFILE 181 
session types 

intercommunication facilities 296 
logical units 281,300 
SESTYPE operand 281 

DFHTCT TYPE=REMOTE 281 
DFHTCT ?YPE=SYSTEM 296 
DFHTCT TYPE=TBRMINAL 319 
with TRMTYPE, DFHTCT TYPE=TERMINAL 300 
SETEOM macro 510 
shared resources, VSAM 749 
sharing TCTTE information, DFHTCT 
TYPE-REGION 279 


short wait interval 225 
SHE operand 155 

DFBNLT TYPE=INITIAL 151 
sign—on procedure 230 
sign-on table (DFHSNT) 230 
SIMODS operand 220 
single keystroke retrieval 34 
SIT, system initialization table 
(DFBSIT) 201 
SIVOL=YES operand 436 
SKK operand 221 
SKR3270 operand 34 
SMF data for monitoring 685 
SMI operand 66 

SNA character string (SCS) 508 
SNT, sign-on table (DFHSNT) 230 
source—compatible interfaces 7 
specific error conditions, DFHTEPT 


TYPE=BUCKET 385 
SPURGE operand 174 
SRBSVC operand 21 
SRCHM operand 118 
SRCHTYP operand 124 
SRP operand 221 
SRP, system recovery 
PROGRAM=SRP) 54 
SRT operand 221 
SRT, system recovery 
STAGE2 operand 13 
DFHSG PROGRAM=ATP 
DFHSG PROGRAM=BFP 
DFHSG PROGRAM=CSD 
DFHSG PROGRAM=CSO 
DFHSG PROGRAM=CSS 
DFHSG PROGRAM=CSU 
DFHSG PROGRAM=DBP 
DFHSG PROGRAM=DCP 


program (DFHSG 


table (DFHSRT) 

24 

25 
35 

37 

38 

39 

39 

40 
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STAGE2 operand (continued) 

DPHSG PROGRAMEDIP 40 
DFHSG PROGRAM=EIP 41 
DPHSG PROGRAM=EXP 42 
DPHSG PROGRAM=GAP 45 
DPHSG PROGRAM=HLL 45 
DPHSG PROGRAM=IC? 46 
DPHSG PROGRAM=JCP 48 
DPHSG PROGRAM=KPP 50 
DPHSG PROGRAM=MTP 52 
DPHSG PROGRAH=0CP 52 
DPHSG PROGRAM =SCP 54 
DFHSG PROGRAM=SRP 55 
DPHSG PROGRAM=TBP 55 
DFHSG PROGRAM-TCP 57 
DPHSG PROGRAM=TDP 69 
DFHSG PROGRAM=TRP 70 
DPHSG PROGRAM=TSP 71 
DPHSG TYPE=INITIAL 19 
START operand 221 
START parameter, EXEC CICS ENABLE 
command 554 

start—of—message indicator (SMI), 2260 
STARTER operand 

DPHSG TYPE=INITIAL 20 
starter system generation (DPHSG 
PROGRAM=PREGEN) 53 
starter system library 11,19 
startup, TCAM 526 
STATERR operand 

DFHJC TYPE=CLOSE 439 
DFHJC TYPE=GET 441 
DPHJC TYPE=OPEN 437 
static CICS/VS area requirements 630 
CICS/VS modules 630 
CICS/VS table sizes 635 
static reference set 646 
station address 281,320 
station control feature 273 
statistics output 

data base files 748 
DL/I data bases 748 
dumps 747 

dynamic transaction nackout 751 

intercommunication facilities 751 

journals 750 

programs 747 

storage 746 

tasks 745 

temporary storage 750 
terminals 747 
transactions 746 
transient data 750 
VSAM shared resources 749 
statistics, journal management 433 
STATUS operand 585 
STATUS=FIRST operand 21 
STN2980 operand 281,320 
STOP parameter, EXEC CICS DISABLE 
command 557 

storage control program (DFHSG 
P ROGRAM=SCP) 53 
storage cushion 

SCS operand 220 
size 220 
storage area 639 
storage recovery 54 


storage requirements 
CICS/VS 630 

CICS/VS reference set 645 
operating system 645 
storage violation dump 222 
storage, statistics output 746 
strings 119 
strings (GET only) 122 
STRNO operand 

DFHFCT TYPE=ALTERNATE 105 
DFHFCT TYPE=DATASET 119 
DFHFCT TYPE=SHRCTL 131 
STRNOG operand 105,122 
structure of this manual 3 
SUFFIX operand 13,81 

DFHALT TYPE=INITIAL 82 
DPHDCT TYPE=INIT1AL 85 
DFHDCT TYPE^SDSCI 95 
DFHDLDBD TYPE=INITIAL 349 
DFHDLPSB TYPE=INITIAL 348 
DFHFCT TYPE=INITIAL 103 
DFHJCT TYPE=INITIAL 137 
538 DPHMCT TYPE=INITIAL 142 

DFHNLT TYPE=INITIAL 151 
DPHPCT TYPE=INITIAL 160,162 
DFHPLT TYPE=INITIAL 190 
DFHPPT TYPE^INITIAL 193 
DFHSG PROGRAM=BFP 25 
DFHSG PROGRAM=BMS 27 
DFHSG PROGRAM=CSA 34 
DPHSG PROGRAM=DBP 39 
DFHSG PROGRAM=DCP 40 
DPHSG PROGRAM=DIP 40 
DPHSG PR0GRAM=EXP 42 
DFHSG PROGRAM=PCP 43 
DFHSG PROGRAM=ICP 46 
DPHSG PROGRAM=ISC 48 
DFHSG PROGKAM=JCP 48 
DFHSG PROGRAM=KPP 50 
DFHSG P ROGRAM=PCP 52 
DPHSG PROGRAM=SCP 54 
DPHSG PROGRAM=SRP 55 
DFHSG PROGRAM=TCP 57 
DFHSG PROGRAM=TDP 69 
DPHSG PROGRAM=TRP 70 
DPHSG PROGRAH=TSP 71 
DFHSIT 204 

DFHSRT TYFB=INITIAL 236 
DPHTCT TYPE=INITIAL 248 
DFHTLT TYPE=INITIAL 333 
DFHTST TYPE=INITIAL 336 
DFHXLT TYPS=INITIAL 339 
superset ISAM logic module, DFHFCT 
TY?E=LOGICMOD 

multiple ISAM data sets 125 
SVD operand 222 
SWITCH operand 289 
switched BSC temporary text delay 
(TTD) 396 

switched line disconnected bit 392 
switched—line pools 265 
switching dump data sets, DPHOC 
TYPE =S WITCH 604 
SYMBADR operand 603 
SYNAD operand 291 
syntax notation 3 
SYSIDNT operand 249 

DPHDCT TYPE=REMOT£ 92 
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YSIDNT operand (continued) 

DFHDLPSB TYPE=ENTRY 349 
DFHFCT TYPE=HEMOTB 126 
DFHPCT TYPE=REMOTE 183 
DFhTCT TYPB=REGION 279 
DFHTCT TYPE=REMOTE 281 
DFHTCT TYPE=SYSTEM 294 
DFHTCT TYPE=TERMINAL 321 
DFHTST TYPE-REMOTE 337 
ystem abend 427 
ystem abend code 236 

ystem attend, abnormal termination 427 
ystem entry (TCTSE) 

locate a particular entry 579 
ystem generation 11 

ATP, asynchronous transaction 
processing program 24 
BFP, built-in functions program 24 
BMS, basic mapping support program 25 
CSA, common system area 34 
CSD, control system dummy group 34 
CSO, control system operational 
group 35 

CSS, control system service group 38 

CSO, control system utility group 38 
DBF, dynamic transaction backout 

program 39 

DCP, dump control program 39 
DFHSG macros 13 
DFHSG PROGRAM=ATP 24 
DFHSG PROGRAM=BFP 24 
DFHSG PROGRAM=BMS 25 
DFHSG PROGBAM=CSA 34 
DFHSG PROGRAM=CSD 34 
DFHSG PROGRAM=CSO 35 
DFHSG PROGRAM=CSS 38 
DFHSG PROGRAM=CSU 38 
DFHSG PROGRAM=DBP 39 
DFHSG PROGRAH=DCP 39 
DFHSG PROGRAM=DIP 40 
DFRSG PROGRAM=EIP 40 
DFHSG PROGRAfl=EXP 41 
DFHSG PROGRAM=FCP 43 
DFHSG PROGRAM=GAP 44 
DFHSG PROGRAM=HLL 45 
DFHSG PROGRAM =1CP 46 
DFHSG PROGRAM=ISC 46 
DFHSG PROGRAM=JCP 48 
DFHSG PROGRAM=KCP 49 
DFHSG PROGRAM=KPP 50 
DFHSG PROGRAM=MTP 51 
DFHSG PROGRAM=OCP 52 
DFHSG PROGRAM=PCP 52 
DFHSG PROGRAM=PREGEN 53 
DFHSG PROGRAM=SCP 53 
DFHSG PROGRAMMER 54 
DFHSG PROGRAM^TBP 55 
DFHSG PROGRAM-TCP 55 
DFHSG PROGRAM=TDP 69 
DFHSG PROGRAM-TRP 70 
DFHSG PROGRAM-TSP 71 

DIP, batch data interchange program 40 
DL/I 75 

EIP, exec interface program 40 
EXP, command (EXEC) language translator 
program 41 

FCP, file control program 43 
GAP, graphic attention program 44 


system generation (continued) 

HLL, high-level language support 
group 45 

ICP, interval control program 46 
initialization, DFHSG TYPE=INITIAL 14 
intercommunication facilities 46 
JCP, journal control program 48 
KCP, task control program 49 
KPP, keypoint program 50 
modules generated 741 
MTP, master terminal program 51 
OCP, dynamic open/close program 52 
PCP, program control program 52 
PREGEN, starter system generation 53 
recovery/restart 73 
SCP, storage control program 53 
SRP, system recovery program 54 
TBP, transaction backout program 55 
TCP, terminal control program 55 
TDP, transient data control program 69 
termination, DFHSG TYPE=FINAL 72 
TRP, trace control program 70 
TSP, temporary storage control 
program 71 

TYPE=FINAL operand 72 
system initialization overlays 
DFHSIT 220 

system initialization program 575 
system initialization processing 188 
system initialization table (DFHSIT) 201 
system log 492 
system log data set 456 
system logical unit number 255 
system or user abend exit creation 427 
system prefix, journal records 445 
system recovery program (DFHSG 
PROGRAM=SRP) 54 

system recovery table (DFHSRT) 236 
system restart data set 456 
system sense codes received by DFHZNAC 772 
system stall purge indicator 174 
system stall time interval 
ICVS operand 214 
system/3, TCT example 714 
system/7 

IPL status 326 
special features 287 
transaction to IPL 531 
SYSWAIT operand 139 


tab feature, 2260 535 

TAB operand 66 
table preparation 79 

ALT, application load table 81 
DCT, destination control table 84 
DL/I 345 

FCT, file control tattle 101 
ISC 353 

JCT, gournal control table 136 
MCT, monitoring control table 141 
NLT, nucleus load table 146 
PCT, program control table 159 
PLT, program list table 188 
PPT, processing program table 192 
recovery/restart 341 — 

SIT, system initialization table 201 
SNT, sign—on table 230 
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table preparation (continued) 

SRT, system recovery table 236 
TCT, terminal control table 239 
TLT, terminal list table 332 
TST, temporary storage table 335 
XLT, transaction list table 339 
2260 compatibility for 3270 534 

TAB2980 operand 281,321 
TACLS 

action and information bits 391 
address contents 387 
DSECT, format description 389 
information 372 
terminal error program 365 
task abend exit creation 420 
task attach user exit (XTCATT) 524 
task control program (DFHSG 
PROGRAM=KCP) 49 
TASKNO operand 321 
TASKRBQ operand 

DFRPCT TYPE=ENTRY 164 
DFHXLT TYPE=ENTRY 340 
tasks 

statistics output 745 
tasks, maximum number per transaction class 
CMXT operand 208 
TBLFIX operand 66 

TBP, transaction backout program (DFHSG 
PROGRAM=TB P) 55 
TCAM 507 

abend/restart 527 

application program interface 511 

communication control byte (s) 521 

data format 512 

DD card correlation 511 

default actions taken by DFHTACP 520 

devices 521 

error messages and codes 753 

generalized message format 522 

input event 524 

input process gueue 512 

input user exit (XTCTIN) 524 

line input/output area (I10A) 525 

line locking 518 

line pool restrictions 518 

line pool specifications 517 

logic flow 513 

message control program (MCP) 511,529 

message handler 511 
message routing 517 

multiprocessor recovery procedures 477 

OPTCD operand 517 

output event 524 

output process gueue 278 

output user exit (XTCTOtJT) 524 

permanent line lock 519 

POOL feature 278,517 

pool of common TCTTEs 512 

process gueue 279 

gueue considerations 519 

gueue locks 519 

segment processing 517 

seguence of events 513 

startup 526 

task attach user exit (XTCATT) 524 
TCT example 720 
temporary line lock 519 
terminal entries 512 


TCAM (continued) 

terminal error program 516 
terminal errors 

terminal abnormal condition 
program 363 

terminal control program 363 
terminal error program 363 
termination 527 
TPROCBSS block 511 
unsolicited input 520 
user exits 524 
work area 524 
work unit 290 
XTCATT 524 
2260 522 

3270 523 

TCAM SNA 508 

batch processing 510 
communication control byte(s) 509 
device message handler (DMH) 508 
devices 279 
error processing 510 

batch logical units 510 
FMH processing 509 
IEFRH macro 509 
MCP examples 777 
protocol management 508 
SETEOM macro 510 
SNA character string (SCS) 508 
TCAMFET=SNA operand 279,508 
transaction control 509 
with CICS/OS/VS 508 
TCAMFET=SNA operand 279,508 
TCAHSIP=YES operand 37 
TCAPCARO field 427 
TCLASS operand 174 
TCM3270=YES operand 68 
TCP operand 222 

TCP, terminal control program (DFHSG 
PROGRAM=TCP) 55 
TCT operand 222 

TCT, terminal control table (DFHTCT) 239 
TCTLEs (terminal control table line 
entries) 265 
TCTSE (system entry) 

locate a particular entry 579 
TCTTE 

locate a particular entry 579 
TCTTEs (terminal control table terminal 
entries) 297 
TCTUA operand 22 
TCTUAL operand 276,321 
TDP operand 222 

TDP, transient data control program (DFHSG 
PROGRA M=TDP) 69 

TEBs (terminal error blocks) 366 
telecommunications errors 73,341 
teletypewriter (WTC only) 

disconnect message, DFHTCT 
TYPE=TLXMSG 328 
error conditions 397 
station identification, DFHTCT 
TYPE=TLXID 327 
TCT example 708 

teletypewriter exchange terminal (CPT— 
TWX)/TCT example 707 
temporary line lock 519 
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:emporary storage 
ageing limit 336 
backout 460 
control program 71 
dataids 336 
emergency restart 470 
message cache 49 2 
recovery 460 
statistics output 750 
:emporary storage control program (DFHSG 
PROGRAM=TSP) 71 

temporary storage table (DFHTST) 335 
‘BP default table 367 
*EP error table 366 
'ERM operand 582,586 

DFHTC CTYPE=LOCATE 582 
;erminal 

statistics output 747 
terminal abnormal condition line entry 
(TACLE) 365 

terminal address, BTAM 323 
:erminal control program (ACF/VTAM 
portion) 401 

terminal control program (DFHSG 
PROGRAM=TCP) 55 

:erminal control table (DFHTCT) 239 
:erminal control table line entry 
(TCTLE) 265 

terminal control table terminal entry 
(TCTTE) 297 

terminal control table user area 259 
terminal control, DFHTC macros 500 
terminal entries, TCAM 512 
terminal error blocks (TEBs) 366 
:erminal error program 363 
CICS/VS components 363 
error messages and codes 753 
error messages and default actions 753 
errors and actions unigue to TCAM 516 
non—VTAM error actions 753 
switched BSC temporary text delay 
(TTD) 396 

TCAM 516 

teletypewriter (NTC only) 397 
terminal abnormal condition line entry 
(TACLE) 36 5 

when abnormal condition occurs 363 

2740 model 2 397 

3270 locked buffer 399 

3270 unavailable printer 398 

3275 dialed 30-second timeout 399 

3600 BSC 399 

7770 32—second timeout 396 
:erminal error purge indicator 174 
:erminal identification 257 
:erminal identification and error—code 
lookup 368 

terminal input area length 256,257 
:erminal input/output area length 281,321 
:erminal line group type 252 
terminal list table (DFHTLT) 332 
:erminal locate function, DFHTC 
CTYPE=LOCATE 579 
:erminal model number 257,276 
terminal operators, DFHSNT TYPB=3NTRY 232 
:erminal scan delay interval 214 
;erminal status 325 

terminal types, DFHTCT TY?E=TERMXNAL 297 


terminals, remote entries 
DFHTCT TYPE=REMOTE 279 
termination, system generation 72 
termination, TCAM 527 
TERMTST operand 289 

test response to CTYPE requests, DFHTC 
CTYPE=CHECK 586 

test transaction backout response 473 

text—read errors 285 

text—write errors 286 

TIME operand 384,408 

TIOAL operand 281 

DFHTCT TYPE-SYSTEM 296 
DFHTCT TYPE=TERMINAL 321 
TLT, terminal list table (DFHTLT) 332 
TLXID operand 327 
total processor utilization 616 
TPMARK=NO operand 96 
TPP operand 222 
TPROCESS block 511 
TPURGE operand 174 
trace control program (DFHSG 
PROGRAM=TRP) 70 
trace table alignment 157 
trace table entries 223 
trace table entries, user exit 
interface 559 

track search, SBCHM operand 118 
transaction 

automatic initiation (ATI) 59,501 
class 174 

maximum number of tasks (CMXT) 208 
class, logical units 497 
code 

TRAHSID operand 322,340 
control information, DFHPCT 
TYPE=ENTRY 162 
control, TCAM SNA 509 
description options, DFHPCT 
TYPE=0PTGRP 179 
execution times 614 
identification 

TRANSID operand 164 
options 501 
priority 175 
restart facility 172,425 
security key 174 
status 175 
TWASIZE operand 175 
types 

BASE 613 
ECHO 613 

work area size 175 
transaction abend 415 

abnormal termination 416 
creating task abend exit 420 
DFHPC TYPE=SETXIT macro 419 
HANDLE ABEND command 419 
program error program (DFHPEP) 421 
program isolation deadlock 347 
restart facility 425 
transaction backout 422 
user exits in DFHDBP 422 
transaction backout 456 

committed output message 461 
data base backout 459 
data written to system log 461 
default data base backout 459 
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transaction backout (continued) 

DL/I backout 464 
DL/I backout table 458 
DL/1 error—exit 469 
emergency restart 456 
file backout table 458 
file-error—exit 468 
functions performed 456 
initial input record 463 
initialization 457 

initialization/termination exit 466 
input—exit 467 
logical unit of work 457 
message backout table 457 
message cache 463 
message recovery 456 
message recovery and 
resynchronrzation 460 
message—originated transactions 461 
non-message-origxnated transactions 461 
printer reset 473 
program (DPHSG PROGRAM=TBP) 55 
table 457 

temporary storage backout 460 
temporary storage recovery 460 
transient data recovery 463 
user input exit 459 
user—written exits 465 
transaction list table (DFHXLT) 339 
transaction processor utilizations 615 
TRANSACTION status 325 
transaction-class error routine 497 
transaction-class error—handling 
routine 409 

transactions, statistics output 746 
TRANSCEIVE status 326 


TRMMODL operand (continued) 

DFHTCT TYPE=TERMINAL 323 
TRMPOSN operand 258 
TRMPRTY operand 258,325 
TRMSTAT operand 296 
ACF/VTAM 501 
DFHTCT TYPE=GPBNTRY 258 
DFHTCT TYPE=TERMINAL 325 
TRMTYPE operand 

DFHTCT TYPE=LINE 268 
DFHTCT TYPE=REMOTE 281 
DFHTCT TYPE=TERMINAL 300 
TRMUAL operand 259 
TRNPRTY operand 175 
TRNSTAT operand 175 
TRNSUFX operand 86 
TRP operand 222 

TRP, trace control program (DFHSG 
PROGRAM=TRP) 70 
TRT operand 223 
TSAGE operand 336 
TSEGIND operand 128 
TSMGSET operand 223 
TSP operand 223 

TSP, temporary storage control program 
(DFHSG PROGRAM=TSP) 71 
TST operand 223 

TST, temporary storage table (DFHTST) 
TWASIZE operand 175 

TWASIZE, CICS/VS—supplied transactions 
TWXOFF operand 66 
TWXON operand 66 

TYPE=ALTERNATE operand, DFHFCT 104 
TYPE=B0CKET operand, DFHTEPT 385 
TYPE=CHECK operand, DFHKP 474 
TYPB=CLOSE operand 


TRANSEC operand 

DFHPCT TYPE=ENTRY 174 
DFHPCT TYPE=INITIAL 162 
TRANSID operand 

DFHDCT TYPE^INTRA 91 
DFHPCT TYPE=ENTRY 164 
DFHTCT TYPE=TERMINAL 322 
DFHXLT TYPE=ENTRY 340 
transient data control program (DFHSG 
PROGRAM=TDP) 69 
transient data recovery 69,463 
transient data, statistics output 750 
translate tables 66 
transmission code 271 
transmission control unit 255 
trigger level 84,92 
TRIGLEV operand 91 
TRMADDR operand 256,323 
TRMFEAT operand 256 
TRMIDNT operand 
ACF/VTAM 505 
DFHTCT TYPE=GPENTRY 257 
DFHTCT TYPE=REMOTE 281 
DFHTCT TYPE=SYSTEM 296 
DFHTCT TYPE=TBRMINAL 300 
DFHTEPT TYPE=PERMTID 382 
DFHTLT TYPE=ENRTY 333 
TRMINL operand 257 
TRMKODL operand 

DFHTCT TYPE=GPENTRY 257 
DFHTCT TYPE=LINE 276 
DFHTCT TYPE=REMOTE 281 


DFHJC 438 
DFHOC 603 

TYPE=CSECT/DSECT operand 205 
TYPE=DATASET operand, DFHFCT 107 
TYPE=DEFILU operand, DFHSNEP 407 
TYPE=DEF3270 operand, DFHSNEP 406 


TYPE=EMP operand 

TYPE=ENTRY 

operand 

DFHALT 

82 

DFHDLDBD 

> 349 

DFHDLPSB 348 

DFHJCT 

137 

DFHNLT 

152 

DFHPCT 

163 

DFHPLT 

190 

DFHPPT 

193 

DFHSNT 

232 

DFHTLT 

333 

DFHXLT 

339 


TYPE=ERRPROC operand, DFHSNEP 410 
TYPE=ERRPROC operand, DFHTEPM 379 
TYPE=EXTRA operand, DFHDCT 87 
TYPE=GETB/GETF/NOTE/POINT operand, 
DFHJC 440 

TYPE^GPENTRY operand, DFHTCT 252 
TYPE=GR00P operand 
DFHPCT 176 
DFHPPT 197 

TYPE=INDACC operand, DFHFCT 123 
TYPE=INDIRECT operand, DFHDCT 88 
TYPE=INITIAL operand 81 
DFHALT 82 


335 

694 
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2=INITIAL operand (continued) 

)FHDCT 85 

)FHDLDBD 349 

)FHDLPSB 348 

DFHFCT 103 

DFHJCT 137 

)FHMCT 142 

)FHNLT 151 

DFHPCT 160 

)FHPLT 190 

DFHPPT 193 

)FHSG 15 

DFHSNEP 406 

DFHSNT 231 

DFHSRT 236 

)FHTCT 248 

DFHTEPM 374 

DFHTEPT 381 

)FHTLT 333 

)FHTST 336 

DFHXLT 339 

3=INTR A operand, DFHDCT 89 
3=IRCBCH operand, DFHTCT 259 
3=LDC operand, DFBTCT 260 
B=LDCLIST operand, DFHTCT 264 
3=LINE operand, DFHTCT 266 
2=L0GICM0D operand, DFHFCT 125 
B=OPEN operand 
DFHJC 4 36 
DFHOC 599 


B=0PTGRP operand 180 

B=PERMCODE/ERECODE operand, DFHTEPT 383 
3=PERMTID operand, DFHTEPT 382 
3=PR0FILE operand, DFHPCT 
)FHPCT 181 

S=REC0RD operand, DFHMCT 144 

2=RECOVERY/ENTRY operand, DFHTST 336 

3=REGION operand 279 

B=REM0TE operand 

DFHDCT 92 

DFHFCT 126 

DFHPCT 183 

DFHTST 337 


B=RTBOCTL operand, DFHKP 472 
3=RTBODATA operand, DFHKP 473 
E=RTBOEND operand, DFHKP 473 
B=SDSCI operand 
DFHDCT 93 
DFHTCT 282 


B=SECURITY operand, DFHTST 337 
B=SEGDEF operand, DFHFCT 127 
3=SEGHEAD operand, DFHFCT 128 
B=SEGLAST operand, DFHFCT 129 
B=SEGSET operand, DFHFCT 129 
B=SHRCTL operand, DFHFCT 131 
B=SWITCH operand, DFHOC 604 
E=SYSTEM operand, DFHTCT 293 
E=SYSTEM/USER operand, DFHSRT 236 
B=TERMIMAL operand, DFHTCT 300 
B=TLXID operand, DFHTCT 327 
E=TLXMSG operand, DFHTCT 328 
S=7770MSG operand, DFHTCT 329 
BFLE operand 95 


RAN operand 66 
(see user exit interface) 


unsolicited input 

PUNSOL operand 65 
TC AM 520 

uppercase translation 66,312 
USAGE=MAP operand 196 
use count for BMS maps 196 
user activity keypointing 
frequency 474 
keypoint records 474 
transaction CSKP 474 
user exit interface 551 
CICS/VS exits 560 
DFHtJEXIT TYPE=EP macro 553 
exceptional conditions 558 
exit programs 552 
EXITS=YES operand 210 
migrating from existing facility 552 
trace table entries 559 
user exits 

asynchronous transaction processing 569 
CRDR exit routine 570 
CWTR exit routine 572 
CICS/VS ACF/VTAM terminal control 502 
CICS/VS management programs 

conventions and guidelines 565 
dynamic transaction backout 422 
TCAM 524 

transaction backout program 465 
user input exit 459 
user prefix, journal records 447 
user—supplied abend code 236 
user—supplied error processors, DFHSNEP 
TYPE=ERRPROC 410 

user—written node error programs 408 
common subroutine vector table 413 
default transaction-class routine 409 
DFHNET DSECT 412 
DFHZNEPI macros 409 
DFHZNEPI TYPE=INITIAL 409 
error status blocks 412 
NEPCLAS operand 171,182 
node error blocks 412 
node error table header 412 
session failures 414 
user—written error processors 410 
user—written terminal error programs 387 
abend transaction bit 392 
address contents of TACLE 387 
DFHTEP recursive retry routine 393 
disconnect switched line bit 392 
dummy terminal indicator 392 
example 393 

format description of TACLE DSECT 389 
non-purgeable task 392 
switched line disconnected bit 392 
TACLE, action and information bits 391 
write abort bit 392 


validation attributes (3270) 312 

VERIFY=YES operand 119 
Version 1 compatibility 22,37 
VF operand 281,326 
virtual storage 629 

application programs 641 
CICS/VS dynamic storage area 638 
operating system and major access 
method requirements 629 
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virtual storage (continued) 

OSCOR definition 640 
static CICS/VS area requirements 630 
virtual storage access method (see VSAM) 
virtual telecommunications access method 
(see ACF/VTAM) 

VOLERR operand 437,441 
volume error 437 
VOLUME operand 437 
volume switching 138 
VRC/LRC checking feature 273 
VSAM 

alternate index structure 
FCT example 135 
buffer space 112 
buffer storage 640 
buffers 111 

ICIP and mixed mode files 602 
intrapartition queues 69 
mixed mode files, DFHFCT 
TYPE=ALTERNATE 103 
operand 20 

reusable data sets 109 
shared resources 20 
shared resources control, DFHFCT 
TYPE=SHRCTL 130 

shared resources statistics output 749 
VSAMSHR operand 20 
VSAMSHR operand 20 
VSE 

abend codes 238 
file names 255 
VTAM (see ACF/VTAM) 

VTAMDEV operand 67 
V1CMPAT=Y2S operand 37 


warm keypoint 453 
warm restart 453 

full warm restart 453 
HOT start (PPT) 453 
system generation 74 
table preparation 342 
warm keypoint 453 
weighted retrieval function, DFHSG 
PROGRAM=BFP 24 

word processing media, LUTYPE4 261 

word processor (LUTYPE4) logical 
unit 68,301 


work area 524 


working 

storage 

639 

WRAPLST 

operand 

68 

write abort bit 

392 

WRKAREA 

operand 

223 

XLATEID 

operand 



DFHTC CTYPE=LOCATE 583 
XLT operand 224 

XLT, transaction list table (DFHXLT) 339 
XPSB operand 230 
XSNAMS operand 

DFHTCT TYPE=SYSTEM 297 
XSP operand 224 
XTCATT exit, TCAM 524 
XTCMOUT exit, TCAM 524 
XTCTIN exit, TCAM 524 
XTP operand 224 


XTRAN operand 230 
XTRAHID operand 175 
XZCATT exit, ACF/VTAM 502 


ZCP operand 224 

ZIflPUT exit, ACF/VTAM 502 


10/63 character magnetic stripe reader 164 


1050 data communication system, TCT 
example 702 


2260 display station 
CMPT60L operand 62 
COMPAT operand 

DFHPCT TYPE=ENTRY 167 
DFHSG PROGRAM=TCP 62 
DFHTCT TYPE=TERHINAL 308 
compatibility for 3270 533 

table preparation 534 
DFHSG PR0GRAM=GAP 44 
FEATURE operand 534 
FMT2260 operand 64 
FORMAT mode 533 
formatted screen 535 
FULLBUF mode 533 
initiating transactions 539 
line addressing 539 
lock feature 539 
model—dependent data stream 535 
modes of 3270 compatibility 
FORMAT mode 533 
FULLBUF mode 533 
new—line symbol (NL) 538 
screen format 277,324 
screen formats 64 
screen techniques 535 
start—of-message indicator (SMI) 538 
tab feature 535 
TCT examples 
local 719 
remote 703 

2845/2848 tab feature 539 


2314 direct access storage facility, TCT 
example 717 


2540 card read punch/1403 printer, TCT 
example 716 


2740 communication terminal 

model 2, 10—second delay 397 
TCT example 704 
2741 TCT example 704 


2770 data communication system, TCT 
example 713 
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>780 data transmission terminal, TCT 
example 713 


>845/2848 tab feature 539 


’980 general banking terminal system, TCT 
example 709 


!270 information display system 
ERRATT operand 

DFHTCT TYPE=INITIAL 248 
DFHTCT TYPE=LINE 271 
DFHTCT TYPE=TERHINAL 310 
generate logical units 300 
large screen support 

ALTPGE operand 261,302 
ALTSCRN operand 281,303 
ALTSFX operand 304 
DEFSCRN operand 281,309 
SCRNSZE operand 161,173 
locked buffer, DFHTEP 399 
PA/PF keys 164 

printer authorization matrix 219 
prxnter selection 

ALTPRT operand 319 
PRINTTO operand 319 
TCAH 523 
TCT examples 
BTAM 710 

BTAM, local (OS/VS) 718 
large screen support 725 
VTAM 725 
3275 (VSE) 714 
terminal features 310 
unavailable printer 
DFHTEP 398 
DFHZNEP 413 
2260 compatibility 533 
3275 dialed 30-second timeout, 
DFHTEP 399 


>00 finance communication system 
BSC 

buffer depletion 546 
poll list 545 
system generation 545 
TCT example 712 
terminal control table 
preparation 545 
generate logical units 300 
TCT example 722 
3600 pipeline logical unit 
TCT example 723 

3614 consumer transaction facility 
TCT example 722 


30 plant communication system logical 
nit 302 


50 retail store system 
generate logical units 300 


3650 retail store system (continued) 

TCT examples 

host command processor LO 724 
host conversational (3270) LU 724 
host conversational (3653) LU 723 
interpreter LU 724 
pipeline LU 723 


3735 programmable buffered terminal 
inquiry mode 541 
system generation 541 
TCT example 715 

terminal control table preparation 541 


3740 data entry system 
ID verification 544 
system generation 543 
TCT examples 

dial/switched (VSE) 715 
multipoint (VSE) 711 
point—to—point 716 

terminal control table preparation 543 
3741 sign—on 543 


3767 communication terminal 
generate logical units 300 
TCT example 728 


3770 data communication system 
generate logical units 300 
TCT examples 

batch data interchange LU 729 
extended local LDC list 732 
full function LU 730 
LDCs for batch LU 731 
non—programmable 728 


3780 data communication terminal, TCT 
example 711 


3790 communication system 

generate logical units 300 
TCT examples 

batch data interchange LU 731 
extended local LDC list 732 
full function LU 730 
inquiry LU 731 
SCS printer LU 731 
3270—display LU 730 
3270-printer LU 730 
3270—compatible LUs 300 


7770 audio response unit 
CAA operand 37 

channel/abnormal end appendage 
program 36 

0S/VS TCT example 705 
read/irrite program 36 
SVC program 36 
VSE TCT example 706 
32-second timeout 396 
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